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INTRODUCTION 

This book is a collection of discoveries about the VIC, how and why it 
works, and how to use these facts to write better programs and perfornn nnore 
interesting functions. The book is divided into five sections, each section 
covering one of the principal functional blocks into which the basic VIC 
connputer can be divided. The different aspects of the VIC dealt with in each 
section cover nnost of the advanced applications for which the VIC can be 
used. 

The VIC is produced in several slightly different versions, in different parts 
of the world. This book is written for version 7 machines which are designed 
for use with European PAL TV sets. The US version 6 machines use the 6560 
VIC chip which IS compatible with the US 525 line TV. The Japanese version 1 
machines use the 6560 and also have Japanese character keyboard and 
character generator. There are slight differences in the operating system 
software of these three versions but they do not affect most of the information 
in this book. 

I should like to thank Commodore UK and Commodore US for their 
assistance in writing this book, in particular the following people: John Baxter 
and Malcolm North of CBM UK and Mike Tomczyk, Shiraz Shivji and Bob 
Russell of CBM US. 

Nick Hampshire 
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Fig. 1 — Block diagram of internal structure of 6502. 



THE 6502 MICROPROCESSOR 

When a program is run on the VIC all the instructions are perfornned 
by one connponent, the nnicroprocessor. There are a range of different 
nnicroprocessors, this particular device is nnanufactured by MOS 
Technology and known as the 6502. It is an eight bit nnicroprocessor, 
eight bits nneaning that dunng each instruction or operation cycle, 
eight bits of data are operated upon or transferred sinnultaneously. 

A block diagrann of the internal structure (known as the systenn 
architecture) is shown in Figure 1. This may appear rather connplex, 
but it can be divided into two sections. One called the control section, 
the other the register section. The control section lies on the nght side 
of the drawing, the register section on the left. All the processing is 
carried out within the register section of the chip, instructions 
obtained fronn progrann nnennon/ are innplemented by a series of data 
transfers within this section. Each of the 56 different instructions 
which the 6502 recognises involves a unique set of data transfers. It is 
the control section which recognises the instruction, and initiates the 
correct sequence of data transfers. The instructions enter the 
processor via the data bus and are latched into the instruction register 
to be decoded by the control logic. Since nnost instructions require 
nnore than one data transfer within the register section, a source of 
tinning signals is required to ensure the correct sequence, this is done 
by the tinning control unit. 

Each data transfer which takes place within the register section, is 
the result of the decoding of the instruction register and the tinning 
control unit by the control logic, whose outputs enable the relevant 
registers. When progrannnning at a nnachine level a prinnan/ concern is 
the control and nnanipulation of data within the processors registers. 
To understand the function of the nnicroprocessors instruction set, 
one nnust understand the function of its registers. 



MEMORY USAGE AND THE 6502 INSTRUCTION CYCLE 

The 6502 microprocessor has a 16 line address bus, this enables it to 
access 2^^ or 64K of nnennory. Any one of the 65,536 memory locations 
can be accessed by the processor placing the correct binan/ value 
corresponding to the memory location on the address bus. The eight 
bits or byte of data located at the addressed memory location can 
then be read, or if required changed, via the eight line data bus. Since 
all the processor registers and memory are only eight bits long it 
requires two bytes to specify a sixteen bit memon/ address. The 
bottom eight bits are referred to as the high order address. By dividing 
the 16 bit address into two 8 bit sections the entire addressable 
memon/ area can be split into logical blocks, or pages. Memon/ within 
each page can be addressed using the low order address byte, each 
page has 256 memon/ locations and there are 256 pages. Page zero 
starts at location and ends at address 255, page one goes from 
address 256 to 511. Apart from two important exceptions the concept 
of paging is not important to the programmer, these being, page one 
which contains the processor stack, and page zero which has special 
addressing modes. 

It is usual to express memon/ addresses and their data contents in 
hexadecimal notation, this being easier to wnte than binan/, yet more 
easily converted into binan/ than a decimal value. The convention is to 
identify hexadecimal values by preceding the value with a dollar sign, 
this prevents any confusion as to whether the value is in hexadecimal 
or decimal. In hexadecimal any address is represented as a four digit 
value, the first two digits being the high order address byte and the 
bottom two digits the low order address byte. The paging concept is 
thus clearly seen in a hexadecimal address. Any data value is 
represented in hexadecimal as a two digit value. 

Memon/ is used by the processor for the storage of both programs 
and data, the data can be either included within the program, usually 
as constants, or in separate data tables. Programs can be stored either 
in RAM or ROM memon/ but variable data can only be stored in RAM 
memon/. Each instruction in a machine code program requires 
between one and three bytes of memon/. With a one byte instruction 
the data on which it operates is stored in one of the processor 
registers. A two byte instruction consists of the instruction first 
followed by a one byte operand, this can be either a zero page address 
or a data constant. An instruction occupying three bytes contains the 
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Fig. 2 — Relation between address, data, and memory location. 
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Fig. 3 — How a program is stored in memory. 



instruction followed by a full sixteen bit address in the fornn; low order 
byte followed by high order byte. 

When the processor executes the progrann instructions stored in 
nnemon/ it goes through a fixed instruction cycle, this gets the 
instruction from nnennorY, perfornns the instruction, and then repeats 
by getting the next instruction, and so on until the end of the program. 
There are three stages in the instruction cycle, they are; 

1) fetch the instruction. 

2) decode the instruction. 

3) execute the instruction. 

Fundamental to the operation of the instruction cycle is the internal 
processor register called the program counter. The program counter 
holds the 16 bit address of the next instruction, and the first stage in 
the instruction cycle is to transfer the contents on the program 
counter onto the address bus. The instruction located at that memory 
address is then transferred to the processor instruction register. The 
second phase of the cycle is to decode the contents of the instruction 
register to generate the correct sequence of internal and external 
signals to perform the execution stage of the cycle. The execution 
phase of the cycle depends on the instruction and will include the 
fetching of any operand bytes plus the manipulation of one or more 
processor registers. After fetching an instruction or an operand byte 
the program counter is incremented by one so that at the end of the 
instruction cycle it contains the address of the next instruction and 
the process is repeated. 



Fig. 4 — Sequence of processor operations in executing an instruction. 

Step 1 — progrann counter points to location of instruction by 
placing the memory address on the address bus. 

Step 2 — the instruction code is transferred from memory to the 
instruction register where it is decoded. 

Step 3 — the program counter is incremented to point to the operand 
byte of the instruction in the following memory location, 
this byte is placed in the accumulator. The decoded instruc- 
tion then results in a specific operation being performed on 
the byte in the accumulator. 

Step 4 — The program counter is incremented to point to the next 
instruction In memory and the sequence returns to step 1 . 
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THE ACCUMULATOR AND THE ARITHMETIC UNIT 

The accumulator has no exact function, it is a general purpose 
register. To nnove a byte of data fronn one part of nnennon/ to another it 
nnust be tennporarily stored in the accunnulator. The accunnulator is 
also used to store the internnediate and final results of a logic or 
arithnnetical operation. 

Data transfers between the accunnulator and nnennon/ (since the VIC 
IS a nnennon/ nnapped systenn this also includes I/O) are ven/ innportant 
and account for about 40% of all the instruction used in a nnachine 
code progrann. To nnove a byte of data fronn one nnennon/ location to 
another requires two instructions: 

LDA, M 1 — Load accunnulator with contents of first nnennory 

location. 

STA,M2 — Store contents of accunnulator in second nnennon/ 

location. 
Mennon/ locations Ml and M2 are accessed by one of a variety of 
addressing nnodes, these will be looked at later in this section. Having 
loaded a byte of data into the accunnulator the processor can be 
instructed to perfornn arithnnetic or logical operations upon it. Only 
about three percent of all instructions in a progrann are arithnnetic or 
logical operations. 

Since the 6502 is an eight bit nnachine all the arithnnetic and logical 
operations are between two eight bit nunnbers. The arithnnetic or 
logical operation is perfornned in the ALU or arithnnetic logic unit, this 
requires that one of the operands is in the accunnulator and the other 
is in a nnennon/ location. The result of the operation is placed in the 
accunnulator. Placing the results in an eight bit accunnulator causes a 
problenn when adding two nunnbers whose sunn is greater than 255. 
This is overcome by giving the accumulator a ninth bit, called the 
cam/. The cam/ bit, or flag, is one bit in the processor status register, 
and is set when the contents of the accumulator exceed 255. This 
applies to the performance of binan/ arithmetic by the processor, the 
6502 is fairly unique in that it can also do decimal arithmetic. In this 
mode each byte contains two binan/ coded decimal numbers, 
numbers from to 99 can be stored as a single byte. As in the binan/ 
mode, the carry flag is set when the addition of two numbers gives a 
result greater than 99. The processor is placed in the decimal mode by 
a "set decimal nnode" instruction, SED, which sets another bit within 
the processor status register. 



There are two basic arithmetic instructions, ADC — which is "add 
nnennory to accunnulator with earn/", and SBC — which is "subtract 
nnennon/ fronn accunnulator with borrow". Both instructions can be 
either binan/ or decinnal in nature and can use a variety of addressing 
nnodes to indicate the nnennon/ location. 

The ADC instruction adds the value of the data in the nnennon/ 
location, plus the earn/ fronn the previous operation, to the value in 
the accunnulator, storing the results in the accunnulator. If the result 
exceeds 255 in the binan/ nnode, or 99 in the decinnal nnode, then the 
earn/ flag is set, if the result is zero then the zero flag is set. An 
exannple, if we want to add the two nunnbers, 25 and 189, and store 
the result in nnemon/ location 10 (decinnal) we could use the following 
sequence of instructions: 

CLC 18 (this clears the earn/ flag) 

LDA25 A9 19 (Load accunnulator with 25) 

ADC 1 89 69 BD (Add 1 89 to accunnulator and earn/) 
STA10 8D0A00 (Store result in location 10) 

The instructions in the left colunnn are in nnnennonic code, followed 
by a decinnal nunnber or nnennon/ location. The sanne sequence of 
instructions appears on the right as hexadecimal values. Addition of 
two numbers where one or both have values greater than 255 needs a 
process known as multiple precision addition, calling for the use of 
the earn/ flag. Adding two sixteen bit numbers, requires two 
additions. The earn/ is first cleared and the two lowest order bytes, (a 
sixteen bit number would be stored in two bytes of memon/) added 
together. The result of this addition is stored in a memon/ location as 
the low order byte of the result. Now the two high order bytes are 
added, plus any earn/ generated by the first addition, the sum stored 
as the high order byte of the result. Using this method numbers of any 
size can be added together, whether the processor is in binan/ or 
decimal mode. 

Addition can be performed on signed numbers. Positive numbers 
added to negative numbers, or two negative numbers added. The 
sign is stored as bit seven of the highest order byte, a zero for positive 
and a one for negative. Addition takes place as in ordinan/ arithmetic, 
the only exception being that the cam/ flag for the highest order byte 
is replaced by the overflow flag. This performs the same function but 
records an overflow or cam/ from bit seven, rather than bit eight. 
Negative numbers are stored not as ordinan/ binan/ numbers but as 



two's complement, which is best described as the inverse of that 
nunnber minus one. All the ones become zeros and vice versa for all 
bits, except bit one, thus binan/ five is normally 00000101 — in two's 
complement form it become 11111011. 

The SBC instruction subtracts the value of data in a memon/ 
location (and borrow) from the value in the accumulator, storing the 
result in the accumulator. Two's complement arithmetic is used 
throughout. The borrow flag is the same as the cam/ flag used in 
addition, whereas before an addition the cam/ flag is always cleared, 
before a subtraction it is always set. The result of subtraction affects 
the cam/ or borrow flag, it is set if the result is greater than or equal to 
zero. Similarly for subtraction of signed numbers the overflow flag is 
set if the result exceeds +127 or — 127 for single precision seven bit 
arithmetic. The SBC instruction can be used with either binan/ or 
decimal numbers with both multiple precision and signed arithmetic. 
To subtract two decimal numbers, say, 18 from 27 use the following 
sequence of instructions, the decimal mode is used to illustrate its 
function: 

(set decimal mode instruction) 

(set borrow flag) 

(load accumulatorwith 27) 

(subtract 1 8 from accumulator and borrow) 
8D OA 00 (store result in location 1 0) 

The instructions on the left are in mnemonic code, on the right in 
hexadecimal, note that in the decimal mode the hexadecimal and 
decimal numbers are the same. 

The 6502 instruction set does not include instructions to perform 
multiplication or division. Users requiring these functions must write 
special subroutines to perform them, or use the subroutines within 
VIC Basic. Multiplication is a process of repeated addition: 3 x 5 is the 
same as 5 + 5 + 5. For large numbers this could be a lengthy process, 
and programming tricks are required to minimise this. Division is a 
process of repeated subtractions: 15/5 can be performed as the 
following sequence, 15 — 5 = 10, 10 — 5 = 5, 5 — 5 = 0, since three 
subtractions were required, the answer is 3. As with multiplication, 
programming techniques are needed to reduce the time taken to 
divide large numbers. 

Besides arithmetic operations the ALU can perform logical 
operations between data in memon/, and the accumulator. There are 
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four such instructions AND, BIT, OR and EOR. The AND instruction 
perfornns a bit by bit logical AND operation between a nnemon/ 
location and the accunnulator, storing the result in the accunnulator. 
This operation can be used to reset or nnask a single bit or group of bits 
in a nnennon/ location. In the decinnal nnode each byte holds two digits, 
the AND instruction can be used to extract one digit. Where there is a 
zero in the operand, there is a zero in the result. To nnask out the nnost 
significant decinnal digit stored in the bottonn four bits, the 
accumulator is ANDed with 00001111 or hexadecimal OF 
LDA 25 A9 25 (load the accumulator with decimal 25) 

AND OF (hex) 29 FO (AND the accumulator with 00001 1 1 1 binan/) 
STA 10 8D OA 00 (store the result in location 1 0) 

On running this program location 10 will contain 05, the 2 being 
masked out and replaced by a 0. The BIT instruction is identical to the 
AND, except that the result is not stored in the accumulator and only 
the status register flags are set. 

The OR instruction performs a binan/ OR on a bit by bit basis 
between the contents of the accumulator and a memon/ location, the 
result is stored in the accumulator. The main use of this instruction is 
to set a bit or group of bits in a memon/ location, a logical 1 in the 
operand field produces a 1 in the corresponding bit of the result. The 
EOR or "Exclusive OR instruction" is identical to the OR, except that a 
logical 1 appears in the result only if there is a 1 in the operand field, 
and a in the accumulator for the corresponding bit. The main use of 
the EOR instruction is to produce the two complement of a byte. 
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ADDRESSING MODES 

Every instruction in a machine code progrann contains infornnation 
on the position of the data on which that instruction will operate. The 
sanne instruction can exist in several fornns depending on where the 
data is located and each of these forrTis is referred to as an addressing 
nnode. There are thirteen different addressing nnodes and nnost 
instructions can be performed in more than one mode. The LDA 
instruction can use one of eight different modes of addressing. The 
thirteen address modes can be divided into seven basic modes and 
six modes which are combinations of one of the basic modes and the 
indexed addressing mode. 

Implied 

Accumulator 

Immediate 

Absolute 

Zero page 

Relative 

Indirect 

Absolute X indexed 
Absolute Y indexed 
Zero page X indexed 
Zero page Y indexed 
Indirect indexed 
Indexed indirect 

The simplest mode is Implied addressing, which is used exclusively 
by single byte instructions operating on the internal processor 
registers. In an instruction like CLC (Clear Cam/) no data is accessed 
therefore no address is required. It is implied that a register, in this 
case the Status Register, is to be operated upon. 

Accumulator mode addressing is used in instructions which 
perform logical operations on data in the accumulator. This mode is a 
version of implied addressing and all instructions are single byte. 

Immediate addressing is used whenever the programmer wants to 
perform an operation using a constant. To put a value of, say 25, in the 
accumulator we would use the LDA instruction in the Immediate 
mode. In this form of addressing the data is stored in the byte 
immediately following the OPCODE. 
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Neither the Immediate or Implied addressing modes use a memory 
address where data is stored, and are of little use in operations with 
variables. To address any location in memory would require a full 
sixteen bit or two byte address stored in the Operand part of the 
instruction. This address points to a memon/ location where the 
variable upon which the operation being performed is currently 
located, or is to be stored. This form of addressing is known as 
"Absolute addressing". 

A shortened form of absolute addressing can be used when the 
memon/ location being accessed lies on page zero of memon/. This is 
the only case where the concept of paging has any importance in the 
6502, page zero is just the bottom 256 memon/ locations. This is called 
"Zero Page Addressing", and uses a single byte address to point to 
the location of data within page zero. A two byte Zero page address 
mode instruction is much faster than three byte Absolute addressing 
and it is good practice to store all variables in page zero. When running 
machine code programs on the VIC only the bottom 1 44 bytes of page 
zero should be used, storing data in locations above this will probably 
cause the machine to crash. 

A special form of addressing is used exclusively by branch and jump 
instructions, known as "Relative addressing". In this addressing 
mode the instruction is followed by a single byte Operand. This does 
not specify an address as in zero page addressing, but a displacement 
from the address where the branch instruction is stored. Since the 
displacement must be either positive or negative, bit eight is used to 
signify the jump direction, this allows the jump to be up to 127 bytes 
forward or 1 28 bytes backward. 

In some programs it may be necessan/ to have a computed address 
rather than a fixed address, as in absolute addressing. This is done 
using indirect addressing, instructions in this mode have just a single 
eight bit address field which points to the effective address as two 
bytes in page zero. The data address is thus not stored directly in the 
Operand field of the instruction, but, indirectly in page zero, all the 
indirect addresses are indexed except for the JMP instuction. 

Indexed addressing uses the contents of one of the two index 
registers as an offset to the address stored as the Operand part of the 
instruction. The address stored in the Operand can be either an 
absolute two byte address, or a zero page single byte address. This 
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gives a total of four different indexed addressing modes, two for each 
index register. The primary use of indexed addressing is in the access 
of successive memon/ locations used for the storage of a table or 
block of data. 
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THE PROCESSOR STATUS REGISTER AND THE USE OF FLAGS 

The processor status register occupies a very important position in 
the systenn architecture of the 6502. It is an eight bit programnnable 
register, unlike the other registers and its function lies between the 
control and register section of the processor. It is the only register 
which actually affects the control logic. Seven of the eight bits are 
used, and each bit, or flag, has a specific function. 

Flags fall into three categories, those controllable only by the 
progrannnner, those controllable by both progrannnner and processor, 
and lastly those controlled solely by the processor. Only one flag falls 
into the first catagon/, the Decinnal nnode or D flag, occupying bit three 
of the status register. This flag controls whether the processor 
perfornns binan/ or decinnal arithnnetic. It can be set by a SED 
instruction, after which all anthmetic is perfornned in the decinnal 
nnode, until the D flag is cleared by a CLD or clear decinnal nnode 
instruction. 

Three flags fall into the second category: Carn/, Overflow and 
Interrupt disable. The Carn/ or C flag is located in bit of the status 
register, it is nnodified either by the results of certain arithnnetic 
operations or by the progrannnner. The earn/ is also used as a ninth bit 
during arithnnetic operations or by the shift and rotate instructions. 
The instruction used to set the earn/ flag is SEC, it can be cleared by 
CLC. 

The Overflow or V flag occupies bit six of the status register, and is 
used during signed binan/ anthnnetic to indicate that the result was of 
greater value than could be contained within the seven bits of the 
signed byte. The V flag has the sanne nneaning as the earn/ flag, but 
also indicates that a sign correction routine nnust be used if this bit is 
"on", since the overflow will have erased the sign in bit seven. The 
progrannnner can only clear the V flag by using the CLV instruction. 

The Interrupt disable, I flag, controls the operation of the 
nnicroprocessor interrupt request input, and is located in bit two of 
the status register. Interrupts play a ven/ important part in the VIC's 
design, and each tinne there is an interrupt the I flag is set by the 
processor. This stops the processor being interrupted by nnore pulses 
on the IRQ line until the interrupt handling progrann has been 
connpleted with a return note an interrupt instruction clearing the I flag. 
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The I flag can also be set by the programmer with an SEI instruction to 
prevent the processor being interrupted, as during a precision timed 
loop subroutine. At the end of such a program the interrupt line can be 
returned to its normal function by clearing the I flag with a CLI 
instruction. 

The last three flags: Zero, Negative and Break, are controlled solely 
by the processor. The Zero and Negative flags are either set or reset by 
nearly even/ processor operation. The Zero or Z flag is set by the 
processor whenever the result of an operation is 0, as when two 
numbers of the same value are subtracted from each other. The 
Negative or N flag is set equal by the processor to bit seven of the 
result of an operation. One of its priman/ uses is during signed binan/ 
arithmetic, if the N flag is set then the result is a negative number. The 
Break or B flag is set by the processor during an interrupt service 
sequence. The Z flag occupies bit one, the N flag bit seven and the B 
flag bit four of the status register. 

The seven status bits or flags in the status register each have a 
meaning to the programmer at a particular point in the program. 
Although the cam/ and overflow flags are used in arithmetic 
operations the major use of flags is in combination with the 
conditional branch instructions. This gives the programmer the 
capability of incorporating decision making instructions within a 
program, to test a flag, and, depending on the state of that flag, take 
one or two courses of action. A conditional branch is functionally the 
same as the IF... THEN GOTO... statement in Basic. There are a range of 
these instructions performing different functions and testing 
different flags. Anyone writing a machine code program must keep 
track of the expected state of all flags at even/ instant throughout the 
program. Failure to do this is one of the commonest causes of a 
program not working or producing the wrong result. An example 
would be failure to clear the carry flag before an addition. On odd 
occasions it would have been set by a previous instruction, and thus 
give rise to erroneous results. 
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BRANCHES, JUMPS AND THE PROGRAM COUNTER 

To understand the use of branch and jump instructions the concept 
of program sequencing must be understood, and its control by the 
program counter. The program counter, or PC, consists of two eight 
bit registers. Like the other registers they communicate with the 
internal processor data bus, but the outputs are also connected to the 
sixteen lines of the address bus. One of the PC registers is connected 
to the bottom eight address lines and is called PCL, the other, the PCH 
is connected to the eight high order address lines. Although two eight 
bit registers, they function like a single sixteen bit register. It is the 
program counter which controls the addressing of memon/, by being 
a program, or data address pointer and, as such it contains the address 
of the next memon/ location to be accessed. 

At the beginning of the program the PC must contain the address of 
the first instruction. This is one of the functions of the operating 
system reset software. It is also preformed by the SYS and USR 
commands when entering a machine code program from Basic. The 
instruction fetched from memon/ is stored in the instruction register, 
to be decoded by the control logic. This process takes one clock cycle, 
during which time the program counter is incremented by one to 
point to the next memon/ location. The processor usually requires 
more than one byte to interpret an instruction, this first byte contains 
the basic operation and is known as the OP CODE. The following one 
or two bytes, known as the OPERAND, contain either a byte of data or 
the address of the data on which the operation will occur. An 
instruction may require up to three sequential memon/ locations, the 
program counter first points to the OP CODE which is fetched from 
memon/ and stored in the instruction register. The PC is incremented 
and poir^ts to the next memon/ location, the contents of which are 
fetched and stored in the ALU, in a three byte instruction this will be 
the low order address of the data. The program counter is again 
incremer^ted and the high order address fetched from the third 
memon/ location. The processor then latches the two bytes of the 
address onto the address bus via the ALU, fetches the data, and 
performs the operation. Having completed the operation, which 
usually takes about four clock cycles, the processor increments the 
program counter to point to the next instruction and the process is 
repeated. In this manner the program counter will continue to 
advance until it reaches the maximum memon/ location, fetching 
instructions and addresses. 
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A sequential program would lack a feature fundamental to 
computing, the ability to test the result of an operation, and 
implement various options based on the results of the test. Firstly 
flags can be used to test the result of an operation, secondly the 
contents of the program counter must be changed to point to the start 
of a new program. The simplest way of changing the contents of the 
program counter is with the JMP or "Jump to new location" 
instruction. This as its name implies does not perform any tests on the 
results of a previous operation. It simply loads a new sixteen bit 
address into the program counter thereby forcing the processor to 
start operating at the new address. The JSR or "Jump to Subroutine" 
instruction is similar to JMP except that the current contents of the 
program counter are saved on the stack to be restored on the 
completion of the subroutine by an RTS, "Return from Subroutine" 
instruction. 

There are eight different conditional branch instructions, they can 
be divided into four groups, each testing the state of one of the status 
register flags. The four flags tested by the conditional branch 
instructions are; Cam/, Zero, Negative and Overflow, one instruction 
tests if the flag is set, and the other if it is clear. The two instructions 
for the Carn/ flag are BCC or "Branch on Carry Clear" and BCS or 
"Branch on Cam/ Set". The Operand contains the address to which 
the program jumps if the condition being tested is true. The 
addressing mode used is unique to conditional branch instructions, it 
is called relative addressing. 

In relative addressing the new address is stored as just one byte, 
which is added to the current contents of the program counter. To 
enable the program to branch both forwards and backwards the 
relative address can be either a positive or a negative number. The 
fact that relative branch addresses are stored as a signed single byte 
limits the maximum size of the branch to either 127 bytes forwards or 
128 bytes backwards, this may seem a limitation but in practice it is 
not. 

The eight conditional branch instructions are: 
BMI — Branch on Result Minus 

Testing the N flag 
BPL— Branch on Result Plus 
BCC — Branch on Cam/ Clear 

Testing the C flag 

BCS — Branch on Cam/ Set 
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BEQ— Branch on Result Zero 

Testing the Z flag 






BNE — Branch on Result Not Zero 
BVS — Branch on Overflow Set 

Testing the V flag 
BVC — Branch on Overflow Clear 
Most operations involve the setting of one or more flags, but a small 
group of test instructions are specifically designed to set flags for 
testing by a branch instruction. The most commonly used is the 
"Compare Memon/ and Accumulator" or CMP instruction. It allows 
the programmer to compare a value in memon/ to one in the 
accumulator without altering the value in the accumulator. If the two 
values are equal the Z flag is set, otherwise it is reset. The N flag is set 
equal to bit 7 and the cam/ flag is set when the value in memon/ is less 
than or equal to that in the accumulator. The BIT instruction tests 
single bits in memon/ with the corresponding bits in the accumulator. 



THE STACK REGISTER AND ITS USE 

The stack register is mainly concerned with the handling of 
interrupts and subroutines. It is an eight bit register, its function is 
identical to that of the progrann counter since it is an address 
generator. It is used to point to an address in page 1 of nnennon/, 
(locations 256 to 511), known as the "Stack". The stack is a set of 
mennon/ locations starting at 511 and filled downwards from that 
location with a maximum size of 256 bytes. It is organised as a LIFO or 
"Last In First Out" structure, which means that the last byte of data 
stored on the stack is the first byte to be accessed. Every time data is 
pushed onto the stack the stack pointer is decremented by one, and 
each time data is pulled off the stack, the stack pointer is incremented 
by one. The addressing of the stack is independent of the program and 
based purely upon chronological events. The stack is used as a 
temporan/ data store, the most common data being re-entrant 
addresses generated by subroutines and interrupts. 

Even/ time a subroutine is called in a machine code program the 
current contents of the program counter are saved. On returning from 
the subroutine the program can be re-entered at the correct location. 
Similarly even/ time the processor is interrupted the current address 
in the program counter is saved before the processor performs the 
interrupt servicing routine. A subroutine may call other subroutines, 
requiring the storage of several re-entrant addresses in the stack. The 
last re-entrant address stored is the first address reloaded into the 
program counter at the end of the subroutine, hence the LIFO 
structure of the stack. The calling of subroutines by other subroutines 
is termed "subroutine nesting" and is a common occurrence in 
machine code programs. The size of the stack in the 6502 limits the 
user to 127 levels of nesting, usually far more than is needed. Basic 
subroutines also use the stack for the storage of the return address 
pointers and register contents. 

A subroutine is called by a JSR or "Jump to Subroutine" 
instruction. This pushes the current contents of the program counter 
onto the stack. A location stored as the Operand field is then loaded 
into the program counter. This causes the processor to jump to a new 
section of the program and start execution from the location in the 
program counter. 

The return from a subroutine to the main program is accomplished 
by he RTS or "Return from Subroutine" instruction. This loads the 
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return address from the stack into the progrann counter. It also 
incrennents the progrann counter to point to the instruction following 
the JSR. The stack pointer is also incremented to point to the next 
subroutine address if any. 

The stack can be used by the programmer as a temporan/ storage 
location for data passed to a subroutine. The programmer needs a set 
of instructions to allow him to put data onto the stack and read it 
back. The current contents of the accumulator can be transferred to 
the next location on the stack by the PHA or "Push Accumulator onto 
Stack" instruction. Data can be read from the current location pointed 
to by the stack pointer into the accumulator, by the PLA or "Pull 
Accumulator from Stack" instruction. Both instructions 
automatically cause the stack pointer to be incremented or 
decremented by one. An example of data storage in the stack is saving 
the contents of the processor status and index registers when a 
subroutine is called. The contents of the status register can be pushed 
onto the stack by the PHP "Push Processor Status on Stack" 
instruction and then transferred from the stack back to the status 
register by the PLP "Pull Processor Status from Stack" instruction. To 
save the contents of the index registers they are first transfered to the 
accumulator and then placed on the stack. When writing any machine 
code routine for the VIC which will be called from a Basic program it is 
ven/ important to first save the contents of the processor accumulator 
and index registers on the stack. The contents of these registers are 
then restored prior to returning to Basic. Failure to do this will result 
occasionally in system crashes. 

Normally the stack pointer points to a location in page one, the 
location being automatically incremented or decremented by the 
processor as required, but in some situations the programmer has to 
be able to change the stack pointers contents. The stack pointer is 
loaded by transferring the contents of the X index register to the stack 
pointer with a TXS "Transfer Index X to Stack Pointer" instruction. 
This instruction is used at the beginning of a program to initialise the 
stack pointer, it is performed automatically on the VIC as part of the 
power up reset routine. Re-initialising the stack on the VIC causes 
problems, usually resulting in a crash and should thus be avoided. The 
current contents of the stack pointer can be read by loading it into the 
X index register with a TSX "Transfer Stack Pointer to Index X" 
instruction. 
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THE INDEX REGISTERS 

Having a fixed address in the Operand field of an instruction poses 
problenns when accessing a sequential block of data, such as a table or 
an input buffer. One method would be to use a string of load 
instructions in the fornn, load data from address 1 — perform 
operation — load data from address 2 — perform operation and so on. 
This is obviously highly wasteful of memon/ space, it would be more 
efficient if this program was written as a loop. To do so would require 
that the address stored as the Operand field of the load instruction is 
incremented each time the program goes round the loop. In this way 
the Operand address will always be pointing to the next byte of data 
to be accessed. This method is useful, but, execution time is 
considerably greater than in the straight line programming 
technique, also it is often undesirable to use a self modifying program. 

A more sophisticated approach is the use of a counter, the contents 
of which are automatically added to the address in the Operand field 
of the instruction. Such a counter is called an Index register. There are 
two Index registers in the 6502, both are eight bit registers, labelled X 
and Y. They are used by instructions in one of the indexed addressing 
modes. The simplest is absolute indexed addressing, in this mode the 
contents of one Index register is added to the address in the Operand 
field of the instruction, giving a new address from which data is to be 
accessed. The fact that the Index registers are only eight bit registers 
limits the maximum size of data block accessed using indexed 
addressing to 256 bytes. In practice the majority of tables are shorter, 
it is not therefore a significant limitation. If longer tables are required 
then programming techniques, such as indirect indexed addressing, 
are used to overcome this limitation. 

The Index registers are controlled and manipulated by a range of 
special instructions. A number can be loaded to, or stored from the 
Index register and a memon/ location, by the LDX, LDY and STX, STY 
instructions. Similarly the contents of the Index registers can be 
compared with a value in memon/ to test if a conditional branch 
should take place by using the CPX and CPY instructions. The 
contents of an Index register is changed to point to the next address 
by increments or decrementing it by one. To count up, the instruction 
used is INX or INY, to count down DEX or DEY. The remaining Index 
register instructions allow the transter of the contents of the 
accumulator into one of the Index registers and vice versa. TAX and 
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TAY transfer the accumulator contents into X and Y registers 
respectively and TXA, TYA transfer the Index register contents to the 
accumulator. 

In some programs it may be necessan/ to have a computed address, 
rather than a base address with an offset, as in absolute indexed 
addressing. This is done using indirect addressing, instructions in this 
mode have just a single eight bit address field which points to the 
effective address as two bytes in page zero. The data address is thus 
not stored directly in the Operand field of the instruction but, 
indirectly in page zero, all the indirect addresses are indexed except for 
the JMP instruction. Two modes of indirect addressing are possible. 
Indexed Indirect and Indirect Indexed Addressing. 

Indexed Indirect addressing index register X is added to the 
Operand zero page address. This points to locations where the sixteen 
bit data address is stored. One of the major uses of this addressing 
mode is in retrieving data from a table or list of addresses, as in polling 
I /O devices or performing string operations. 

Indirect Indexed addressing the sixteen bit address pointer in page 
zero is first accessed then offset by the contents of index register Y to 
give the true data address. The location of the pointer is fixed, 
whereas in the indexed indirect mode it is variable being offset by the 
contents of index register X. Indirect indexed addressing combines 
the advantage of an address that can point anywhere in memon/ with 
the offset capability of the index register. It is a particularly powerful 
method of accessing the nth element of a table, providing the start 
address is stored in page zero. 
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DATA MODIFY INSTRUCTIONS 

A small group of instructions are not associated with any particular 
processor register. They are classified as read/nnodify/write 
instructions. They all read data from a memon/ location or 
accumulator, modify it in a particular way and store the modified data 
back into memon/ or the accumulator. These instructions perform 
four different data modifications, shift, rotate, increment and 
decrement. 

A shift instruction is one which takes the contents of the 
accumulator or a memon/ location and shifts all bits one bit to the left 
or right. An example is the LSR-Logical Right instruction, here the 
data in the accumulator or memon/ is moved one bit to the right, bit 
is placed in the earn/ flag and bit seven set to zero. Similarly the 
ASL-Arithmetic Shift Left instruction moves the data one bit to the 
left, bit seven is stored in the cam/ flag and bit set to zero. Repeated 
shifts in the same direction will eventually result in the entire byte 
being set to zero. Herein lies the difference between a shift and a 
rotate instruction. In a rotate instruction the contents of the cam/ flag 
is stored in the bit emptied by the shift, thus no data is lost in a rotate 
instruction. The ROL-Rotate Left instruction shifts the contents of the 
accumulator or addressed memon/ left 1 bit with the cam/ stored in 
bit and bit 7 stored in the carry flag. With ROR- Rotate Right instruction 
the data is shifted right 1 bit with bit shifted into the cam/ and the 
cam/ shifted into bit 7. The shift and rotate instructions have a unique 
form of addressing, in addition to the normal forms, and is known as 
accumulator mode addressing. It indicates that the instruction is to 
operate on the accumulator rather than on a memon/ location. 

Besides shift and rotate the contents of a memon/ location can be 
incremented or decremented. INC-lncrement Memor/ by One adds 
one to the contents of the addressed memon/ location. DEC- 
Decrement Memon/ by One subtracts one in two's compliment form 
from the contents of the addressed memon/ location. The main use of 
increment and decrement is with counters such as table pointers. 
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INTERRUPTS AND INITIALISATION 

The processing of interrupts is innportant for the operation of the 
VIC systenn. As seen in Section 4 all peripheral 1/0 is interrupt driven, a 
knowledge of interrupts is thus required by anyone using the user 
port or the other I/O. There are three input lines which can cause the 
processor to halt on connpletion of the current instruction. On receipt 
of one of these inputs the progrann counter is stored on the stack and 
the processor causes the progrann to junnp to an interrupt servicing 
routine at an address pointed to by the contents of one of the interrupt 
vectors. These three lines are Reset, Interrupt Request or IRQ, and 
Non-Maskable Interrupt or NMI. All three lines can be used by external 
devices attached to the VIC nnennon/ expansion port. Their function 
can be controlled by the progrannnner thanks to the RAM vectored 
address table which allows user written routines to replace the 
systenn routines governing interrupts and reset. 

The only way a progrannnner can change the sequence of operations 
is to load a new address into the progrann counter. If this were true 
then an external event could not effect the progrann sequence, unless 
the progrann was written to periodically check for an input. Most 
inputs are asynchronous, nneaning that for an input to occur at the 
sanne tinne as the progrann is checking for inputs is extrennely unlikely. 
If an input pulse occurred just after an input check, then not until the 
next check would that pulse be input to the connputer. During the 
interval between checks; data at the input nnay have changed resulting 
in the loss of infornnation. To overconne such a data loss the processor 
could be progrannnned to wait for the data, but this would nnean the 
processor spending nnost of its tinne doing nothing. 

The problenn of having the processor wait for an input is overconne 
by having a special line signal the processor whenever an input 
occurs, an interrupt. This considerably sinnplifies progrannnning, 
nnaking it unnecessan/ to repeatedly use an input testing subroutine 
or have the connputer wait for an input. The two interrupt lines used to 
signal to the processor that an input is present are the IRQ line and the 
NMI line. By pulling an interrupt line low for at least 20 nnicroseconds 
an input device can signal that it wishes to send data to the processor. 
This forces the processor to finish its current instruction, store the 
progrann counter and status register on the stack and junnp to a 
nnennon/ location pointed to by the interrupt vector. There are two 
interrupt vectors that for the IRQ line are located at 65,534 and 65,535, 
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for the NMI line at 65.530 and 65,531. The reset vector is located at 
65,532 and 65.533. 

The processor could be interrupted before it was able to retrieve 
data fronn an interrupt initiated input. To prevent this the progrannmer 
can disable the IRQ line and prevent further interrupts by setting the I 
flag in the processor status register. This is done by the first 
instruction in the interrupt handling subroutine, SEI-Set Interrupt 
Disable. A CLI — Clear Interrupt Disable instruction clears the I flag 
and allows the processor to be interrupted as normal. Having 
obtained data fronn the input the interrupt software can process it for 
use by the nnain progrann or respond with an output fronn an 1/0 port. 
Control is returned to the nnain progrann by the RTI-Return fronn 
Interrupt instruction. This pulls the contents of the processor status 
register and progrann counter off the stack restoring the processor to 
its pre-interrupt state. The NMI line can not be disabled with 
connnnands to the processor and will therefore always generate an 
interrupt irrespective of the state of the IRQ line and the Status 
register I flag. An interrupt on the NMI line therefore has a higher 
priority than an input on the IRQ line. The Reset line takes priority over 
both the interrupts causing all the systenn pointers to be reset and a 
Basic warnn start initiated. If the Reset RAM vector address is changed 
then the user written reset routine which it points to nnust clear the 
processor registers, and reset the stack pointer to the beginning of the 
stack, before junnping to the entry point of the nnain progrann. 

The VIC has two sources of interrupt, one fronn each of the 
peripheral 1/0 chips and either one can interrupt the processor. The 
interrupt line fronn one I/O chip (VIA No. 2) is connected to the IRQ line 
(a tinner on this chip generates regular interrupts which control 
update of the clock variable Tl and keyboard scanning). The interrupt 
fronn the other 1/0 chip (VIA No.1) is connected to the NMI line and is 
used to generate a systenn restart when the Restore key is pressed. 
Each I/O chip has two interrupt inputs and one output connected to 
the IRQ or NMI lines. The function of these I/O inputs is dealt with in 
the sections on the 6522 VIA chip and the systenn 1 /O. 

An interrupt sequence can be created by the progrannnner without 
an input being present in the IRQ line, by use of the BRK — Break 
connnnand. This instruction perfornns a software interrupt and causes 
progrann control to be transferred to the address stored in the 
interrupt vector. The nnain use of this instruction is in debugging a 
progrann, however, it calls one of the interrupt routines. Its use on the 
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VIC is not recommended. For VIC users a similar function is provided 
in the machine code monitor with none of the attendant problems of 
the BRK instruction. 
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MACHINE CODE ON THE VIC 

The VIC has an advantage over many other snnall nnicro computer 
systems in that it can be programed in both Basic and machine code, 
this gives the programmer the powerful option of using machine code 
subroutines in a Basic program. The VIC normally runs in the Basic 
mode and there are six ways of accessing the machine code 
environment. The first two use commands in Basic, these are, USR 
and SYS. Both commands access a machine code subroutine whose 
address is specified in the command or in a specific page zero 
location. The next four methods involve adding machine code 
subroutines into the operating system. 

1 — the Basic command USR(X) transfers program control to an 
address stored in locations 1 and 2, this address is user definable and 
will be the start of a machine code subroutine. The value X specified in 
the command is a parameter for use by the subroutine, this is 
evaluated and placed in floating accumulator No.1 starting at location 
$0061. A parameter may be returned by placing it in the floating 
accumulator and providing it is in the correct format then this value 
will be assigned to the parameter variable. 

2 — the Basic command SYS(X) causes program control to jump to 
a machine code subroutine starting at address location X, where X is 
either a variable or a constant value equal to the decimal start 
address. Parameters can be passed between the Basic program and 
the machine code routine using POKE and PEEK commands to place 
or read values from specified memon/ locations. 

3 — if the machine code routines are located in ROM memon/ and 
start at memon/ address No.AOOO then the VIC allows system control 
to jump to this location rather than the normal Basic interpreter when 
the machine is switched on. This is ven/ useful since it allows the user 
to change the VIC system. This can be either adding extra commands 
to Basic, changing the I/O operation using the ROM and RAM jump 
vectors or simply bypassing the Basic and operating system software 
and replacing it with special custom software (this is commonly done 
for cartridge games). 

4 — add a program into the interrupt servicing routines, these are 
called sixty times a second by the keyboard scan interrupt signal. This 
method for example allows the scanning of 1/0 ports for an input, or 
selectively disabling certain keys on the keyboard. Any situation 
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where a program must be run concurrently with the main program 
could use this method. 

5 — involves inserting extra code into the CHARCOT subroutine 
which gets each line of Basic from memory prior to its execution by 
the interpreter. By intercepting each line of Basic before it is executed 
new Basic instructions can be added. The instruction being 
performed by a user written machine code subroutine. Both the 
method of inserting code into the interrupt routine and the addition of 
extra code into the CHARCOT subroutine will be dealt later with in 
full. 

6 — the RAM vector address table can be used to insert code into, or 
replace, any one of the Basic or system routines accessible through 
this table. This is similar to method 4 and could be used to reassign 
the functions of the interrupt lines or change the peripheral I/O 
handling routines. 

The main reason for using machine code subroutines is that Basic is 
too slow for many purposes, especially when using the I/O ports or in 
special purpose display functions. A machine code routine is more 
than 100 times faster than the same program wntten in Basic. 
Another reason for using machine code is that one may want to 
change the operating system or use some of the operating system 
subroutines. 

A machine code program which is loaded into RAM memon/ is best 
located at the top of memon/. This area is used by Basic to store 
character strings, and to avoid these overwriting the machine code 
program the top of memon/ pointers must be changed. The top of 
memon/ pointers are set during power up diagnostics to the highest 
usable RAM location. The location of the top of memon/ and therefore 
the values stored in the top of memon/ pointer bytes depends on 
whether the VIC is fitted with any extension RAM. By lowering the 
value of these pointers a block of memon/ can be reserved exclusively 
for use by a machine code program. The operating system will regard 
the new top of memon/ pointers as containing the highest memon/ 
location usable by Basic. Tiio pointer is stored as the low order byte in 
51 and the high order byte in 52. As an example the following 
commands will lower the top of memon/ to location 4096: 

POKE 51,0 : POKE 52,16 

POKE 55,0 : POKE 56,16 

CLR 
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Locations 55 and 56 are the top of strings pointers and must be set 
equal to the top of mennon/ pointers at the start of the progrann, the 
CLR connnnand resets all the variable pointers thereby clearing all 
vanables used previously in the progrann. Care should be taken when 
locating nnachine code programs in RAM memon/ space that the 
memon/ area used is not also allocated to either video memon/ or 
character generator memon/. 

Of the two Basic commands used to call a machine code subroutine, 
SYS and USR, by far the most powerful and flexible is SYS. With the 
SYS command one simply specifies the subroutine starting location, 
thus if it starts at location 5000 it can be called with SYS 5000. 
Variables can be transferred between a Basic program and a machine 
code program by using PEEK and POKE. These read or write single or 
multiple byte values into memon/ locations allocated for the purpose 
and accessed by both programs. Transferring variables in this manner 
is easier than using the single floating point variable provided for the 
USR function. It also allows the transfer of more than one variable 
which USR does not. The only requirement with a SYS subroutine is 
that the last instruction in the subroutine is a RTS — return from 
subroutine, this automatically returns control to the Basic program. 

The easiest way of entering a machine code program is to 
incorporate it into the Basic program using a simple loader, on 
running the program the loader POKES the values byte by byte into 
the correct locations. Another way is to use the machine code monitor 
which is part of the Programmers Aid ROM pack, a summan/ of all the 
commands in the monitor are given in Appendix 6. The monitor 
allows machine code program to be directly written into memon/ 
using hexadecimal code. It also allows programs to be saved and 
loaded onto tape in machine code format. To make the writing of 
machine code programs easier and avoid the necessity of hand 
encoding, a simple assembler and disassembler are included in the 
monitor. The monitor saves a machine code program by saving the 
block of memon/ where the program is located, far quicker than a 
corresponding Basic loader. 

The only drawback with using the monitor to save and load a 
machine code program is that it will require a two part load, the first 
to load the machine code and the second to load the Basic program 
calling the machine code routine. The Basic program could be saved 
by the monitor together with the machine code, by saving the entire 
contents of user memon/ from location No. $0400 up. Generally it is 
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R5.. 54. F0.. 09 
C6,.54,.rie..F7 
Ii8 



10 REM ***.+:**************************** 
20 REM *BflSIC LOhDER FOR MflCHIHE CODE 
30 REM ^ROUTINE CEKfiMPLE CODE ONL.V> 
40 REM *****************■**.****•**:******* 
100 DflTfl 204S: REM **CuDE STRRT LOCflTIOH 
REM **MflCHIHE CODE IN HEKhDECIMhL 
DhTh 48 .. 98 .. 48 .. 8H .. 48 
DfiTR Fl9. 13.. 20. DS..E3 
pHTfl fl9,. 11.. 20.. D8..E:: 
IiflTfl h5 .. 55 .. F0 .. 09 .. fl9 ,. 1 D .. 20 .. 
DflTfl 68 .. flfl .. 68 .. fly .. 68 . 60 
DflTfl*: REM **EHD OF CODE 
REM **THE FOLLOWING LINES ARE THE BASIC 
REM **LOflDER PROGRAM. 
REflDL 
REflDflf 
C=LEN'::fl$) 
IFfl$="*"THEN9140 
I FC<: 1 0RO2THEN9 1 30 
fl=flSC(fl|:>-48 
E=flSC < R I GHT$ ( fl* .. 1 ) :> -48 



105 

110 

120 
130 
140 
150 

9000 

9005 
9QQ6 
90 1 
9020 
9030 
9040 
9050 
9060 
9070 
9080 
9090 
9 1 00 
9110 
9120 
9130 
9140 
REflDV. 



N=B+7.* ( B>9 > - ( C=2 ) * •: 

I FN<:0ORN>255THENy 1 :: 

POKEL..N 

L=L+1 

GOTO9020 

PRINT"BVTE"L"=C"H$" 

END 



16*':.fl+?*'::fl>9.'.v 
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best to use a Basic loader for short machine code programs which are 
called by the main Basic program. Longer machine code subroutines 
and machine code programs which stand alone and are not called 
from Basic are best saved using the monitor. 

Another method of storing machine code programs is to store them 
within a Basic program as REM statements. To do this the machine 
code program must first be split into blocks, each block being less 
than 80 bytes long. Each byte of the machine code routines is stored 
as a character in the REM statements. The REM statements are stored 
as the first few lines of the Basic program. Each statement is first filled 
with dummy characters, the number of characters in each statement 
depends on the length of the block of machine code to be stored in 
that statement. The machine code monitor is then used to find each 
REM statement as it is stored in memory and replace the dummy 
characters with the code value for each byte in the machine code 
block. When the program is listed the REM statements will appear as 
a seemingly random collection of ASCII characters, each character 
however represents a byte of the machine code routine. When writing 
a machine code program to be stored in this way care should be taken 
to ensure that no absolute jump addresses are used within a block, 
this ensures that the routine is relocatable. Care should be taken to 
ensure that jump addresses from the main calling routine are suitably 
modified to allow for the six byte gaps in the program required for 
storage of line number, link address, command token and terminating 
0, and the location of each routine. 
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WRITING MACHINE CODE PROGRAMS 

The prospect of writing a machine code progrann even a snnall one 
nnay seenn fairly daunting, but providing one uses an orderly and 
disciplined approach to the problenn it need not be difficult. A nnachine 
code progrann differs fronn Basic in the approach taken to its writing. 
Whereas a rough Basic progrann can be written and then polished up 
by inserting and changing lines, a nnachine code progrann nnust be 
written as the final version, any changes often necessitate rewnting 
and assennbling the whole progrann. Machine code unlike Basic code 
is dependent on the exact position of instructions in nnennon/. Adding 
a couple of instructions into the middle of a program means changing 
most jump, branch and data addresses. Machine code programs also 
require far greater attention to details like current flag status, 
programs must be ven/ carefully planned before they are written. 
Unless this is done, writing a machine code program will require far 
greater effort than is necessan/ and the product far more prone to 
error. It is strongly recommended that before wnting any programs in 
machine code yourself, you study some 6502 machine code routines, 
tn/ to determine why the code was written in a particular way and 
what it does. 

Stage one in planning a program is to define what the program is 
required to do, therT break the problem into a senes of steps. To 
demonstrate this consider the following example, to display all the 
ASCII characters on the screen. 

Set the screen location pointer LOG to start of screen, address 
32768 — set the ASCII character value CHAR to zero — store character 
code CHAR on screen at location LOC — increment LOC — increment 
CHAR — if CHAR is greater than 255 then all characters have been 
displayed and program ends, if not then go back and display next 
CHAR. 

From this description we have defined that two variables CHAR and 
LOC are required, also the program structure requires a loop with a 
conditional test. For a short program like this a wntten descnption is 
not really required since one can easily remember what one wants the 
program to do. For longer programs it is an essential part of the 
process. From the written description one can construct a flow 
diagram such as the example in Figure 5. The flow diagram can be 
regarded as a pictonal version of the written description and as a 
result sinnplerto follow. 
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Fig. 5 — Preliminary flow diagram for example routine. 
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For long programs the flow diagram and written description can get 
ven/ involved and confusing. It is good practice to split such a 
program into a series of self contained blocks or subroutine modules. 
Each module is then treated as a complete program, making program 
writing and debugging easier. The flow diagram shows the logical 
pathways through a program and most logical errors can usually be 
detected at this stage, saving a considerable amount of progamming 
time. 

Having drawn a flow diagram the next stage is the construction of a 
table of variables and locations of system subroutines called. In the 
example no system subroutines are used but two variables are 
required: 

LOG — pointer to location in screen memory where character is to be 
stored. 

CHAR — Value for ASCIII characterto be displayed on screen. 
It is important that the table contains all variables required, since 
when writing the program exactly the right amount of space in 
memon/ must be left to contain them. 

Having defined the logical flow of the program, the variables used 
and any system subroutines called, a start can be made on writing the 
program code. Probably the best way is first to draw an expanded 
version of the flow diagram. Breaking down each logical step into a 
series of substeps corresponding to a machine code instruction. In 
Figure 6 notice that the variable LOG is now stored as the contents of 
the X index register. Indexed addressing being the easiest way of 
putting data into successive memon/ locations. Also the index 
register (i.e. LOC) is loaded with 255 and decremented, rather than 
and incremented as in the original flow diagram, since it is easier to 
test for zero than for 255. It should be noted that the coding of this 
example is not the optimum for either speed or compactness but 
rather for clarity so that the purpose of each command is clearly 
visible. 

Having laid out the program in flow diagram form the next step is to 
write the actual code which will be used by the machine. There are 
three ways in which this can be done, the choice of which method is 
used depends on equipment available and the size of the program. 
The first method is to write the code by hand using a coding form 
using the instruction mnemonic or operand address/value in the 
opcode column, see Figure 7. Code written and assembled by hand 
can best be entered into the VIC memon/ by a Basic loader program. 
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Fig. 6 — Expanded flow diagram for example routine. 
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The second method again involves writing the code in mnemonic and 
label form by hand on a coding form, the assembler which is part of 
the monitor on the VIC Programming Cartndge is used to assemble 
the code and directly enter it into the VIC memon/. The third method 
is best used for ven/ long machine code programs and involves using 
a PET computer system (a 32K minimum with disks and printer) on 
which to write and develop the code. The code is written using the 
editor program in the assembler package, this creates a source code 
file on disk, the assembler uses this file during assembly to create an 
opcode file on disk which can be loaded into memon/ using the loader 
routine. 

For hand assembly and coding of a program it is advisable to use a 
coding form such as that shown in the example, it helps to 
considerably reduce the number of errors occunng at this stage. On 
the first page of the coding form should be written a list of all 
variables, I/O locations and system subroutine entn/ points used. 
Each variable being assigned the number of bytes of memon/ which it 
will require. Most will be single byte but some will be two or three 
byte precision and in the case of character variables or data buffers 
memon/ required could be large. When stonng a multiple byte 
numerical vanable it is good practice to store the bytes in fixed order, 
with the least significant byte in the first location and the most 
significant byte in the last location. It is easier this way to keep track of 
which part of a variable is being dealt with. Also index registers can be 
used to access successive bytes of a variable in the same order that 
they are processed. 

Program variables can be stored in any part of RAM memon/ not 
occupied by either programs or system variables. For maximum 
speed and reduced program size vanables should be stored in page 
zero of memon/, the bottom 255 bytes. On the VIC page zero is 
currently occupied by system vanables. This area can be utilised if the 
memon/ locations used are carefully chosen. If Basic is not used, then 
the entire section of page zero used by the Basic interpreter for 
variable storage (locations to 143) is available to the programmer. 
The remaining part of page zero is used by the operating system and 
may or may not be required by the machine code program. If both 
Basic and machine code are to be used together in the same program 
then the number of page zero locations available is limited (locations 
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Fig. 7 - Hand coded program of example routine (note this is the simplest 
though not necessarily the best way of writing this program). 
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87 to 96 are best). If a larger section of page zero memory is required 
then the existing contents should be relocated to a protected part of 
memon/ before the machine code routine is run and restored at the 
end of the routine. 

Using the second expanded flow diagram one can start writing the 
code onto the coding form using the instruction mnemonics. The first 
step is to enter the starting location of the program into the address 
column, then enter the first instruction into the mnemonic column. 
The addressing mode of the instruction should be entered into the 
relevant column. This is important since one must be able to calculate 
how many bytes are required by that instruction, to determine on 
which line (i.e. at which address) the next instruction should be 
entered. The label column will contain an entn/ only if that address is 
the start of a subroutine or the destination of a jump or branch 
instruction. On the flow diagram the position of labels is indicated 
where an operation has more than one entn/ or exit point. The label 
used can be any name but preferably one descriptive of the function of 
the subroutine or loop. In the example the beginning of the program is 
given the label DISPLAY and the entry point of the loop is called 
NEXTCHAR. Entries in the operand column will only be required for 
instructions referencing other locations in the program and will 
consist of symbolic labels and variable names. As program code is 
entered on the coding form the comment column should also be 
completed. Either with simple references to the flow diagram or a 
more complete description. At a later date the function and logical 
flow of the program can thus be easily followed without relying on 
memon/. 

If the machine code routine is to be called from a Basic program 
with either a SYS or USR command then it is ven/ important that the 
contents of the processor registers are saved before the routine is 
executed and then restored at the end of the routine. This is most 
easily done using the stack. The first few instructions of the routine 
push all registers onto the stack and the last instructions restore 
register contents by pulling the correct values off the stack. 



Once written, the program should be checked for logical errors, 
before being assembled. It will involve less work if errors are detected 
prior to assembly. Assembly of short to medium length programs is, in 
the absence of a full assembler running on a PET, best done with the 
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spot assembler function of the nnonitor. Full details of the nnonitor 
functions are given in Appendix 6. The process of hand assennbling is 
done, in the absence of a monitor, in two stages, the first consists of 
using the instruction set list to obtain the opcode value for each 
nnnemonic with the specified addressing mode. This hexadecimal 
value is entered into the opcode column of the coding form on the 
same line as the mnemonic. If the addressing mode is other than 
"implied" or "acumulator" then the following one or two bytes will 
be used to store an address or a value specified in the operand 
column. If the addressing mode is immediate, then the operand 
column contains a hexadecimal value which is transferred to the 
opcode column on the line following that of the instruction code. 

The number system used must always be noted, the conventions 
are that a number prefixed with a % is in binan/ format, with a $ in 
hexadecimal format and if no prefix is given then in decimal format. 
Convention also dictates that an instruction in the immediate mode is 
identified by a No. sign in the address mode column, all other address 
modes are just an abbreviation of the name. For all other modes the 
symbol contained in the operand column will correspond to either a 
label or variable. If a variable, then the address of the variable can be 
obtained from the variable table on the first page of the coding form. If 
the instruction is a jump or branch then the addressing mode used 
will transfer program control to another section of the program, the 
operand column will thus contain a label. Since a label needs the 
calculation of a jump address it is left until the second part of the 
assembly procedure. It should be noted that the 6502 requires that all 
addresses are stored in the form "least significant byte" first, then 
"most significant byte" thus address 0340 hexadecimal is stored as 
4003. 

At the end of the first stage of the assembly process, the opcode 
column on the coding forms should contain a list of hexadecimal 
values, one for each location in memon/. The exceptions being jump 
and branch addresses which are calculated in the second stage. Jump 
addresses pose no problem since they are stored in either indirect or 
more commonly absolute mode. Their entries in the opcode column 
can be obtained from the address of the relevant label. The 
conditional branch instructions all use relative addressing, where the 
branch, either forward or backward, is calculated from the location of 
the branch instruction rather than a fixed location in memon/. It is the 
offset from the current location, which can be up to 127 bytes away. 
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either forward or backward, which must be calculated by the 
programmer. Great care should be taken with this, any error will 
cause program control to be transferred to the wrong place, with 
resultant errors or program crash. To calculate the value for a forward 
branch one counts the number of bytes from the location of the 
branch instruction, to the location of the label in the branch operand 
column, and subtract 2 from this value. If the branch is backwards 
then the offset is calculated by counting the number of bytes from the 
branch instruction to the label, then adding 1 and subtracting from 
255. The result when converted into hexadecimal can be stored in the 
opcode column after the branch instruction. 

Once all jump addresses have been calculated and a complete list of 
opcode values obtained the program can be entered into the 
computer. Before this is done it is advisable to recheck the program, 
especially the opcode listing for errors (make sure that you can 
distinguish between 8 and B or A and 4). The opcode listing is then 
entered into the VIC using either a Basic loader or the machine code 
monitor. Once entered, the program should be saved before it is run 
since it is very rarely that a machine code program runs perfectly first 
time. With the aid of the monitor the contents or memon/ should be 
checked against the opcode listing for any program entry errors. If any 
are found they should be corrected and the program resaved. One can 
then tn/ running it. If there is a program error it will probably crash the 
machine, if so reload the program and the monitor and carefully 
recheck the logic flow, the coding and the contents of memory. In my 
expenence the three most common causes of fatal program errors are 
— entn/ errors, coding errors, and wrongly calculated jump and 
branch addresses. 

The best way of detecting errors is to systematically work through 
the program inserting a break instruction at points where program 
failure may have occurred. This will cause the program to return to the 
monitor, allowing the contents of variable locations to be checked 
and gradually isolate the fault to a small section of code. Another 
way of isolating errors is to run the program from different locations, 
though this does require a careful choice of entry points. Having 
detected and removed any fatal errors one may find that the program 
still does not run properly and produces strange results. Non fatal 
errors are most commonly caused by either a mistake in the basic 
logic flow, ignonng the current flag status, using the wrong variable, 
and quite commonly using the wrong branch instruction. 
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Successful machine code programming is not difficult, it requires 
just a strict adherance to a method and constant attention to detail 
plus plenty of practice. The methods outlined above should enable 
VIC users to expand their machine's capabilities by using machine 
code subroutines. 
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VIC MEMORY MAP 

The 6502 microprocessor used in the VIC is capable of accessing up 
to 64K bytes of nnennory, this nnemory space is divided into blocks 
having a specific function. On the basic VIC only 29K of the available 
64K is utilised, the rennainder is available for user expansion using 
either ROM or RAM nnennon/ or even specialised 1/0, all accessible 
through the nnennon/ expansion connector at the rear of the nnachine. 
The division of the nnennon/ space into blocks with different functions 
is shown in Figure 8. An understanding of the function and location of 
each block is essential if full use is to be nnade of the VIC. 

1 — Systenn vanables — Hex $0000 to $03FF — Decinnal to 1023 
^ The first 1024 bytes of RAM nnennory are utilised by Basic and the 
operating systenn for the storage of systenn variables. The VIC systenn 
configuration and/or its nnode of operation can be changed by placing 
values into specific locations in this section of nnennon/. 

2 — User RAM nnennon/ — Hex $0400 to $7FFF — Decinnal 1024 to 
32,767 — This 31 K block of addressable nnemon/ can be divided into 
four sub sections the first of 7K length and the rennaining three 
sections of 8K length. The first sub section consists exclusively of 
RAM nnennon/ it is nnade up fronn the VIC's built-in 4K user nnennon/ 
which extends fronn location $1000 to $3FFF plus the standard 3K 
expansion RAM which goes fronn location $0400 to $OFFF. If there is 
no other RAM nnennon/ expansion then the top 512 bytes of the first 
section of RAM nnennon/ $1 EGG to $1 EFFF are used as the screen nnennon/ 
(if the High Res nnode is used then in addition to the screen nnennon/ a 
4K block of RAM is required for the progrannnnable character 
generator, see the section on the 6561 for details). If there is nnore than 
7K of user RAM in the systenn then the screen nnennon/ is nnoved to 
start at $1000, decinnal 4096. The three 8K sections of user nnennon/ 
can be either RAM or ROM and are completely free for user programs 
and data with the exception of the screen memop/. 

3 — Character Generator — Hex $8000 to $8FFF — Decimal 32,768 
to 36,863 — The character generator is a 4K ROM which contains the 
pattern of dots used to display each of the 255 valid VIC ASCII 
characters on the screen. The contents of the character generator will 
depend on which language version of the VIC you possess, there are (at 
the time of wnting) three versions. The programmer does not need to 
bother about the character generator in normal character display 
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mode. However, in High Resolution display nnode the character 
generator is not used and therefore to display alphanunneric 
characters in this nnode the data for the desired character nnust be 
transfered from the character generator to the block of RAM used for 
the user definable character generator. 

4 — System I/O and Control Interfaces — Hex $9000 to $91 2F — 
Decimal 36,864 to 37,167 — All the system input, output and control 
lines are memon/ mapped, this means that an I/O line can be turned 
on or off simply by changing the corresponding bit in a specific 
memon/ location. The internal registers of three I/O chips are 
accessable within this block of memon/, they are two 6522 VIA chips 
and the 5621 VIC chip, the latter controls the operation of the video 
display. An understanding of the operation of these three chips is 
essential if any of the many interfaces between the VIC and external 
devices are to be used, consequently two complete sections of this 
book are devoted to these devices. 

5 — Colour Memon/ — Hex $9400 to $95FF — Decimal 37,888 to 
38,399 — Each of the 506 bytes in this block of memon/ determines the 
foreground and background colour of the corresponding byte in the 
video memon/. It should be noted that if there is more than 7K of user 
RAM in the system then the colour memon/ starting address is moved 
up to $9600, decimal 38,400. 

6 — ROM Expansion Memon/ — Hex $A000 to $BFFF — Decimal 
40,960 to 49,151 — This 8K block of memon/ is designed for use by 
programs stored in ROM and contained in a ROM/RAM pack plugged 
into the VIC memon/ expansion port. The VIC operating system 
allows a machine code program, starting at location $A000, to power 
up directly into that program on switching on the machine, rather 
than into Basic. 

7 — VIC Basic Interpreter — Hex SCOOO to SDFFF — Decimal 49,1 52 
to 57,343 — The interpreter translates a high level Basic program, step 
by step into a series of machine code routines, these perform the 
function required for each Basic command. 

8 — VIC Operating System Kernal — Hex $E000 to $FFFF — 
Decimal 57,344 to 65,535 — The operating system controls the 
functioning of the VIC system, such as initialisation on power up, 
communication with peripheral devices, screen display and editing 
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etc. The operating system normally works in conjunction with the 
Basic interpreter but the routines within it can be used by any 
machine code program requiring the operating system functions. 



46 



VIC SYSTEM VARIABLES 

The entire block of memory from location to 1023 is reserved for 
use by the VIC system software, it is used to contain system variables, 
temporan/ data storage, and input/output buffers. This memon/ area 
is accessable to the user via PEEK and POKE commands in Basic, or 
simple load and store commands in machine code (locations 256 to 
511 contain the processor stack, this should not be accessed except 
by processor stack commands in machine code). User accessability of 
this area of memon/ is important since many interesting and useful 
operations can only be performed by reading or changing the 
contents of one or more locations within this bottom 1 K of memon/. 
The function of each location can be seen in Table 1, the programmer 
should study this very carefully before attempting to use or modify 
any of the variables. The memon/ area used by the VIC for variable 
storage can be divided into seven distinct sections each with a 
different function and used by a different part of the system software. 

1 — Basic Interpreter Variables — Hex $0000 to $008F — Decimal 
to 143 — This section of page zero is used exclusively by the Basic 
interpreter and of the variables stored in this section and 1 6 two byte 
pointers stored between location 43 and 74 are the most interesting. If 
machine code subroutines are being used in a Basic program then 
locations 87 to 96 can be used for page zero variable storage, if a 
machine code program is being run which does not require the Basic 
interpreter then the whole 143 bytes in this block may be used for 
vanable storage. If the USR command is used or any of the Basic 
function routines are called from a machine code program then the 
Floating Accumulators 97 — 112 will be required for transfers of 
variables. 

2 — Operating System Kernal Variables — Hex $90 to $FF — 
Decimal 144 to 255 — All the variables and parameters stored in this 
last section of page zero are of interest to the programmer. They 
control the input and output functions of the VIC on the RS232 and 
IEEE port, the allocation of files for I/O with peripheral devices, data 
transfer between the VIC and the cassette deck, the control of the 
screen editor, etc. 

3 — Processor Stack — Hex $01 00 to $01 FF — Decimal 256 to 5 1 1 — 
The section of memon/ occupied by the stack is common to all 6502 
processor systems. The processor uses the stack as a last in first out 
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buffer to store temporary data, such as return addresses in subroutir^e 
calls. The operation of the stack is autonnatically controlled by the 
processor and this area of nnennon/ should only be accessed with 
extreme caution. 

4 — Basic Buffer — Hex $0200 to $0258 — Decimal 512 to 600 — 
These 89 bytes are used to temporarily store text or program lines (a 
line is four screen lines maximum length or 88 characters) during 
input or output operations. When a program line is input it is 
transferred from the Basic input buffer to memon/ by the terminating 
carriage return. The line is then converted into the form in which it is 
stored in memon/, all the commands are converted into tokens thus 
reducing the memory space occupied by the program. This area of 
memon/ should be accessed with extreme caution. 

5 — Operating System Kernal Variables — Hex $0259 to $02FF — 
Decimal 601 to 767 — These operating system parameters and 
vanables do not require to be stored in page zero locations, they are a 
continuation of the variables stored in page zero and deal with the 
same functions. All locations in this section can be usefully accessed. 

6 — Indirect Addressing and Vectored Jumps — Hex $0300 to 
$0334 — Decimal 768 to 820 — This section of memon/ is used to store 
indirect jump addresses for system functions and is thus of 
considerable interest to the programmer. Some of the indirect 
addresses are only temporarily stored here and are not of great use to 
the programmer, 16 addresses are permanently stored here and they 
relate to most of the major operating system functions. These 
operating system vector addresses can be used to access the routines 
or to intercept the routines and either insert some extra code or 
replace the routine entirely. The programmer may want to intercept 
or replace an operating system routine for a variety of reasons. By 
inserting code into the interrupt routine which scans the keyboard 
and updates the screen and clock 60 times a second the programmer 
can, for example, get the VIC to automatically check the user port for 
inputs. The programmer may wish to completely change the 
operating system routines. If a non standard peripheral is connected 
to the VIC then the input and output routines could be changed. The 
use of vectored jump addresses increases the flexibility of the VIC 
system and allows the user to re-define the system to fit a particular 
situation. 
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7 — Cassette Buffer — Hex $033 C to $03 FC — Decimal 828 to 1 020 
— This 193 byte buffer is used in data transfers between the VIC and 
the cassette deck to store each block of data. If the cassette deck is not 
being used then this section of nnennon/ can be used to store small 
machine code programs. 
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$0005- 


-$0006 


5—6 


$0007 




7 


$0008 




8 


$0009 




9 


$000A 




10 


$000B 




11 


$000C 




12 


$000D 




13 


$000E 




14 



$000F 

$0010 
$0011 

$0012 

$0013 

$0014 

$0016 

$0017- 

$0019- 

$0022- 

$0024- 

$002B- 

$002D- 

$002F- 

$0031- 

$0033- 



—$0015 

-$0018 

-$0021 

-$0023 

-$0025 

-$002C 

-$002 E 

-$0030 

-$0032 

-$0034 



15 

16 
17 

18 

19 

20—21 

22 

23—24 

25—33 

34—35 

36—37 

43—44 

45—46 

47—48 

49—50 

51—52 



$0035- 
$0037- 
$0039- 
$003B- 
$003D- 
$003F- 
$0041- 



-$0036 53—54 

-$0038 55—56 

-$003A 57—58 
-$003C 59—60 

-$003E 61—62 

-$0040 63—64 

-$0042 65—66 



FUNCTION 

USR function jump 

Convert float — > integer 

Convert integer — > float 

General counter for Basic. Search 

character ':' orendline 
Scan between quotes flag, 00 as delimeter 
Column position of cursor on line (0 — 87) 
Verify flag 

Basic input buffer pointer;^ subscripts 
DIM flag. First character of array name 
Variable flag, type: FF = string, 00 = numeric 
Integer flag, type: 80 = integer, O0 = floating 

point 
DATA scan flag; LIST quote flag; 

memon/flag 
Subscript flag; FNxflag 
Flags for input or read, = input, 

64 = get, 1 = read 
ATN sign flag: comparison evaluation flag 
Current I/O device for prompt suppress 
Basic integer address (for SYS, GOTO etc) 
Temporan/ string descriptor stack pointer 
Last temporan/ stnng vector 
Stack of descriptors for temporary strings 
Pointer for number transfer 
Misc. number pointer 
Pointer to start of Basic 
Pointer to end of program start of variables 
Pointer to end of variables start of arrays 
Pointer to end of arrays 
Pointer to start of active string space 

(coming down) 
Pointer to top of active strings 
Pointer to end of memon/ 
Current Basic line number 
Previous Basic line number 
Pointer to Basic statement (for CONT) 
Line number, current DATA line 
Pointer to current DATA item 
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$0043— $0044 67—68 
$0045— $0046 69—70 
$0047— $0048 71—72 
$0049— $004A 73—74 
$004B— $004C 75—76 



$004D 



77 



$004E— $004F 78—79 



$0050- 


-$0051 80—81 


$0052 




82 


$0053 




83 


$0054- 


-$0056 


84—86 


$0057- 


-$005B 


87—91 


$005C- 


-$0060 92—96 


$0061- 


-$0066 


97—102 


$0067 




103 


$0068 




104 


$0069- 


-$006E 


105—110 


$006F 




111 


$0070 




112 


$0071- 


-$0072 


113—114 


$0073- 


-$008A 


115—138 


$008B- 


-$008 F 


139—143 


$0090 




144 


$0091 




145 


$0092 




146 


$0093 




147 


$0094 




148 


$0095 




149 


$0096 




150 


$0097 




151 


$0098 




152 


$0099 




153 


$009A 




154 


$009B 




155 


$009C 




156 


$009D 




157 


$009E 




158 



Input vector 

Current variable name 

Current variable address 

Variable pointer for FOR/NEXT 

Y save register-new operator save; 

current operator pointer 
Special nnask for current operator; 
comparison symbol 
Misc. work area; function definition 

pointer hi-lo 
Work area;pointerto string description 
Length of above string 
Constant used by garbage collect, 3 or 7 
Jump vector for functions 
Misc. numerical storage area 
Misc. numberical storage area 
Accumulator^ 1 : E, M, M, M, M, S 
Series evaluation constant pointer 
Accumulator high order propagation word 
Accumulator^2 

Sign comparison, priman/ vs. secondan/ 
Low order rounding byte for Acc# 1 
Cassette buffer length/series pointer 
Subrtn: Get Basic char; 7A, 7B = pointer 

(CHARCOT) 
RND storage and work area 
ST th I/O operation status flag 
Stop key flag: Keyswitch pia. 
Temporan/ 
Load or verify flag 
Cassette/IEEE load temp. IEEE buffered 

char, flag 
IEEE 483 buffered character 
Cassette sync# 
Temp for IEEE input 

How many open files; pointer to file table 
Input device#, normally 
Output CMD device, normally default of 3 
Tape character parity 
Cassette dipole switch 
OS message flag, direct = $50, run = 
Cassette error pass 1 . Temporan/ 
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$009F 159 
$00A0— $00A2 160—162 
$00A3 1 63 
$00A4 1 64 
$00A5 1 65 



$00A6 


166 


$00A7 


167 


$00A8 


168 


$00A9 


169 



$OOAA 



$OOAB 



170 



171 



SOOAC- 


-$00AD172- 


-173 


$OOAE- 


-$00AF 174- 


-175 


$00B0 


176 




$00B1 


177 




$00B2- 
$00B4 


-$00B3 178- 
180 


-179 


$00B5 


181 




$00B6 


182 




$00B7 


183 




$0088 


184 




$00B9 


185 




$OOBA 


186 




$OOBB- 


-$00BC187- 


-188 


$OOBD 


189 




$OOBE 


190 




SOOBF 


191 




$00C0 


192 




$00C1- 


-$00C2 193- 


-194 


$0OC3- 


-$00C4 195- 


-196 


$00C5 


197 




$00C6 


198 




$00C7 


199 





$00C8 



200 



Cassette error pass 2. Temporary 

Jiffy clock 

Serial bit count 

Cycle counter for serial I/O 

Countdown for tape write; sync on tape 

header 
Cassette buffer pointer 
RS-232 receiver input bit storage. 

Tape shortcount 
RS-232 receiver bit count in. Tape read 

error 
RS-232 receiver flag start bit check. 
Tape reading zeros 
RS-232 receiver byte buffer. 
Tape read mode 
RS-232 receiver parity storage. Tape 

shortcount 
Tape start address; tape buffer, scrolling 
Tape end address/end of current progrann 
Temporan/ 
Temporan/ 

Address of tape buffer^l Y. 
RS-232 transnnitter bit count out 
RS-232 transnnitter next bit to be sent 
RS-232 transnnitter byte buffer 
Length of current file nanne string 
Current logical file nunnber 
Current secondan/ address, or 

R/Wconnnnand 
Current device nunnber 
Address of current file nanne string 
RS-232 write shift word/Receive 

input character 
#blocks rennaining to read/write 
Tennporan/ 

Cassette nnanual/controlled switch 
Tape start address (load) 
Tennporan/ 

Matrix co-ordinates of key down 
^of characters in keyboard buffer 
Reverse mode flag, = off, 1 8 = on 
End of line for input pointer 
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$00F5— 6 



$00F9— $OOFA 



$00C9- 


-$00CA201- 


-202 


$OOCB 




203 




$OOCC 




204 




$OOCD 




205 




$OOCE 




206 




$OOCF 




207 




$00D0 




208 




$00D1- 


-$00D2 209- 


-210 


$00D3 




211 




$00D4 




212 




$00D5 




213 




$00D6 




214 




$00D7 




215 




$00D8 




216 




$00D9- 


-$00 F1 


217- 


-241 


$00F2 




242 




$00F3- 


-$00 F4 


243- 


-244 


$00F5- 


-$00F6 245- 


-246 


$00F7- 


-$00F8 


247- 


-248 


$00F9- 


-$00FA 249- 


-250 


$OOFB- 


-$OOFF 


251- 


-255 


$0100- 


-$01 OA 256—266 


$0100- 


-$01 3E 


25^318 


$0100- 


-$01 FF 


256—511 


$0200- 


-$0258 


512- 


-600 


$0259- 


-$0262 


601- 


-610 


$0263- 


-$026C 


611- 


-620 


$026D- 


-$0276 621- 


-630 


$0277- 


-$0280 


632- 


-640 


$0281- 


-$0282 


641- 


-642 


$0283- 


-$0284 


643- 


-644 


$0285 




645 




$0286 




646 




$0287 




647 




$0288 




648 




$0289 




649 




$02 8A 




650 





Cursor log (row, column) 

Shift mode on print flag, which key, 64 

if No. key 
Cursor blink enabled flag, = on, 1 = off 
Delay before cursor blinks 
Character before cursor 
Cursor on/off blink flag 
Input from screen/input from keyboard 
Screen address (row) pointer 

(screen memon/) 
Position of cursor on current text line 
Quote mode flag, = off, 1 = on 
Line length for screen (22, 44, 66, 88) 
Current screen line number 
Contain the ASCII value of last key press 
Insert mode flag 

Screen line table: hi order address and 
line write 

Temporan/ for line index 
Screen editor colour IP 
Keyscan table indirect 
Pointer to RS — 232 receive buffer base 

location 
Pointer to RS— 232 transmitter buffer 
base location 

Free kernal zero page locations 
Floating to ASCII work area 
Taps error log 
Processor stack area 
Basic input buffer 
Logical file number table 
Device number table 
Secondan/ address or R/W cmd, table 
IRQ keyboard buffer 
Start of memon/ 
Top of memon/ 
IEEE timeout flag 
Active colour nibble 
Original colour before cursor 
Base location of screen (MSB) 
Keyboard queue length 
Repeat flag, = cursor control only 

255 = all keys 
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$028B 




651 




$028C 




652 




$028D 




653 




$028E 




654 




$028F- 


-$0290 


655- 


-656 


$0291 




657 




$0292 




658 




$0293 




659 




$0294 




660 




$0295- 


-$0296 


661- 


-662 


$0297 




663 




$0298 




664 




$0299- 


-$02 9A 


665- 


-666 


$029B 




667 




$029C 




668 




$029D 




669 





$029E 



670 



$029F— $02A0 671—672 
$02A1— $02FF 673—767 



Delay before repeat occurs 

Delay between repeats 

Shift flag byte 

Last shift pattern 

Indirect for keyboard table setup 

Shift nnode switch, = enabled, 1 = locked 

Auto scroll down flag (0 = on,o = off) 

6551 control register 

6551 connnnand register 

Non standard (bit tinne/2-100) 

RS-232 status register 

Nunnber of bits to send (fast response) 

Baud rate full bittinne 

RS-232 receiver input buffer index to end 

RS-232 receiver input buffer point to start 

RS-232 transnnitter output buffer index 

to start 
RS-232 transnnitter output buffer index 

to end 
Holds IRQ during tape operation 
Free 





BASIC IN 


$0300- 


-$0301 768—769 


$0302- 


-$0303 770—771 


$0304- 


-$0305 772—773 


$0306— $0307 774 775 


$0308- 


-$0309 776—777 


$030A- 


-$0308 778—779 


$030C 


780 


$030D 


781 


$030E 


782 


$030F 


783 



DIRECT JUMP ADDRESSES 
Indirect error routine 
Indirect nnain connnnand handler 
Indirect tokenisation routine 
Indirect character list routine 
Indirect character dispatch 
Indirect synnbol evaluation 
Tennporan/ storage during SYS of .A 
Tennporan/ storage during SYS of .X 
Tennporan/ storage during SYS of .Y 
Tennporan/ storage during SYS of .F 



54 



KERNAL VECTOR ADDRESSES 



$0314— $0315 
$0316— $0317 
$0318— $0319 
$031 A— $03 IB 
$031C— $031D 
$031 F— $03 IF 
$0320— $0321 
$0322— $0323 
$0324— $0325 
$0326— $0327 
$0328— $0329 
$032 A— $032 B 
$032 C— $032 D 
$032 E— $032 F 
$0330— $0331 
$0332 — $0333 
$033C— $03FC 



788—789 IRQ RAM vector 

790—791 BRK instruction RAM vector 

792—793 NMI RAM vector 

794—795 Open logical file 

796—797 Close logical file 

798—799 Set input device 

800—801 Set output device 

802—803 Reset default I/O 

804—805 Input fronn device 

806—807 Output to device 

808—809 Test STOP key 

81 0-81 1 Get from keyboard 

812—813 Close all files 

814 — 815 Basic USR connnnand vector 

81 6 — 81 7 Load fronn device 

818—819 Save to device 

828—1020 Cassette buffer 



0400— OFFF 1 024—4095 3K expansion RAM area 

1000— 1 OFF 4096—7679 User Basic area 

lEOC^IFFF 7680-8191 Screen mennory 

2000— 3FFF 8192—16383 8K expansion RAM/ROM block 1 

4000— 5FFF 1 6384—24575 8K expansion RAM/ROM block 2 

6000— 7FFF 24576—32767 8K expansion RAM/ROM block 3 



NOTE: When additional nnennon/ is added to block 1 (and 2 and 3), the 
KERNAL relocates the following things for BASIC: 

1000— 11 FF 4096—4607 Screen nnennon/ 
1200—? 4608—? User Basic area 

9400— 95FF 37888—38399 Colour RAM 



8000— 8FFF 32768—36863 4K Character generator ROM 

8000— 83FF 32768—33791 Uppercase and graphics 

840O— 87FF 33792—3381 5 Reversed upper case and graphics 

8C00— 8FFF 35840—36863 Reversed upper and lower case 
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9000— 93FF 


36864- 


9000— 900F 


36864- 


9000 


36864 


9001 


36865 


9002 


36866 


9003 


36867 


9004 


36868 


9005 


36869 



36864—37877 I/O BLOCK 

-35879 Address of VIC chip registers 
bits — 6 horizontal centering 
bit 7 sets interlace scan 
vertical centering 
bits — 6 set No. of colunnns 
bit 7 is part of video matnx address 
bits 1 — 6 set No. of rows 
bit sets 8x8 or 1 6x8 chars 
TV raster beann line 
bits — 3 start of character nnennon/ 
(default^) 

bits 4 — 7 is rest of video address 
(default=F) 

BITS 3,2,1,0 CM starting address 
HEX DEC 



9006 
9007 
9008 
9009 
900A 

900B 

900C 

900D 
900E 



36870 
36871 
36872 
36873 
36874 

36875 

36876 

36877 
36878 



0000 
0001 
0010 
0011 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 



ROM 



RAM 



32768 
33792 
34816 
35840 
0000 

unavail 

4096 
5120 
6144 
7168 



8000 

8400 

8800 

8C00 

0000 

xxxx 

xxxx 

xxxx 

1000 

1400 

1800 

1C00 

horizontal position of light pen 
vertical position of light pen 
Digitized value of paddle X 
Digitized value of paddle Y 
Frequency for oscillator 1 (low) 
(on: 128—255) 

Frequency for oscillator 2 (nnediunn) 
(on: 128—255) 

Frequency for oscillator 3 (high) 
(on: 128—255) 
Frequency of noise source 
bit — 3 sets volunne of all sound 
bits 4 — 7 are auxilan/ colour infornnation 
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900F 36879 Screen and border colour register 

bits 4 — 7 select background colour 
bits — 2 select border colour 
bit 3 selects inverted or nornnal 
nnode 



9110— 91 FF 37136—37151 


6522PIANO. 1 






9110 37136 




Port B output register 










(user port and RS232 lines) 




PIN 


6522 


DESCRIPTION 


EIA 


ABV 


ID 


ID 








C 


PB) 


Received data 


(BB) 


Sin 


D 


PBI 


Request to Send 


(CA) 


RTS 


E 


PB2 


Data terminal ready 


(CD) 


DTR 


F 


PB3 


Ring indicator 


(CE) 


Rl 


H 


PB4 


Received line signal 


(CF) 


DCD 


J 


PB5 


Unassigned 


( ) 


XXX 


K 


PB6 


Clear to send 


(CB) 


CTS 


L 


PB7 


Data set ready 


(CO 


DSR 


B 


CB1 


Interrupt for Sin 


(BB) 


Sin 


M 


CB2 


Transmitted data 


(BA) 


Sout 


A 


GND 


Protective ground 


(AA) 


GND 


N 


GND 


Signal ground 


(AB) 


GND 


9111 37137 




Port A output register 










(PAO)BitO=SerialCLKIN 








(PA1)Bit1=SerialDATAIN 








(PA2)Bit2=JoyO 










(PA3)Bit3=Joy1 










(PA4)Bit4=Joy2 










(PA5)Bit5=Lightpen/F 


ire button 






(PA6) Bit 6=Cassette switch sense 






(PA7)Bit7=SerialATNout 





9112 


37138 


9113 


37139 


9114 


37140 


9115 


37141 


9116 


37142 


9117 


37143 


9118 


37144 


9119 


37145 


911A 


37146 



Data direction register B 

Data direction register A 

Timer 1 low byte 

Tinner 1 high byte 6 counter 

Timer 1 low byte 

Timer 1 high byte 

Timer 2 low byte 

Timer 2 high byte 

Shift register 
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91 IB 


37147 


Auxiliary control register 


911C 


37148 


Peripheral control register 
(CA1.CA2.CB1.CB2) 
CA1 = restore key (Bit 0) 
CA2 = cassette motor control 

(Bits 1-3) 
CB1 = interrupt signal for received 

RS232data(Bit4) 
CB2 = transmitted RS232 data 

(Bits 5-7) 


911D 


37149 


Interrupt flag register 


911E 


37150 


Interrupt enable register 


91 IF 


37151 


Port A (Sense cassette switch) 


9120— 912F 


37152—37167 


6522 PIA No. 2 


9120 


37152 


Port B output register 
keyboard column scan 
(PB3) Bit 3 = cassette write line 
(PB7)Bit7 = Joy3 


9121 


37153 


Port A output register 
keyboard row scan 


9122 


37154 


Data direction register B 


9123 


37155 


Data direction register A 


9124 


37156 


Timer 1 . low byte latch 


9125 


37157 


Timer 1 . high byte latch 


9126 


37158 


Timer 1 . low byte counter 


9127 


37159 


Timer 1 . high byte counter 
timer 1 is used for the 60 time/ 
second interrupt 


9128 


37160 


Timer 2. low byte latch 


9129 


37161 


Timer 2. high byte latch 


912A 


37162 


Shift register 


912B 


37163 


Auxilian/ control register 


912C 


37164 


Penpheral control register 
CA1 Cassette read line (Bit 0) 
CA2 Serial clock out (Bits 1-3) 
CB1 Serial SRQ IN (Bit 4) 
CB2 Serial data out (Bits 5-7) 


912D 


37165 


interrupt flag register 


912D 


37166 


Interrupt enable register 


912F 


37167 


Port A output register 


9400— 95FF 


37888—38399 


Location of COLOUR RAM with 
additional RAM at bik 1 
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9600— 97FF 38400—3891 1 Normal location of COLOUR RAM 

9800— 9BFF 38912—39935 I/O block 2 

9C00— 9FFF 39936-^0959 I/O block 3 

AOOO— BFFF 40960— 491 52 8K decoded block for expansion ROM 

COOO— DFFF 49152—57343 8KBasic ROM 

EOOO— FFFF 57344—65535 8K Kernal ROM 
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VIC USER MEMORY 

The amount of memory available to the user depends on whether 
any RAM expansion cards are attached to the VIC, it will vary between 
3K on a standard VIC to 31 K on a fully expanded system. This memon/ 
space is however not completely available for program storage being 
also required for the storage of string and numeric variables and the 
screen memon/. It is no use writing a program 3K long and tn/ing to 
run it on a standard VIC as this will just result in the operating system 
giving an out of memon/ error. The Basic program is stored from 
location 4097 upwards (if the 3K RAM expansion card is fitted then 
programs start at location 1025) and the string and vanables are 
stored from top of memon/ downwards. 

Program Storage 

When a program line is entered on the keyboard it is first wntten 
into the keyboard buffer. The operating system then transfers it byte 
by byte as it is entered onto the screen. The line however is not 
entered into memon/ until a carriage return is pressed. This causes 
the operating system to transfer the program line just entered from 
the screen into memon/ via the Basic buffer where the line of code is 
compressed and formatted. Each line is stored in a specific format 
using a compressed version of the Basic text. This reduces the 
memon/ requirements of a program and allows longer programs to be 
run. The compression of Basic text involves conversion of the Basic 
commands into single byte tokens. The command PRINT instead of 
being stored as five ASCII characters is stored in a single byte as the 
decimal value 153. When a program is listed the text compression 
process is reversed, as far as the user is concerned the program is 
stored in the same form as it was written. 

A useful result of text compression is a shorthand way of writing 
Basic commands either in a program or direct command mode. This 
relies on the fact that the routine which converts commands to tokens 
looks only at the first two or three characters of a command word. 
Other characters in the command word are there for the users 
convenience only. Normally if we entered only the first couple of 
characters of a command the computer would respond with an error 
message. This can be done by using a simple method of fooling the 
error detection routines. Enter any Basic reserved word, type the first 
letter of the word, then depress the shift key and type the second 
letter. By using just the first two letters there could be confusion 
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VIC-20 BASIC Keyword Codes 



Code 


Character/ 


Code 


Character/ 


Code 


Character/ 


Code 


Character/ 


(decimal) 


Keyword 


(decimal) 


Keyword 


(decimal 


Keyword 


(decimal) 


Keyword 





End of line 


66 


B 


133 


INPUT 


169 


STEP 


1-31 


Unused 


67 


c 


134 


DIM 


170 


-(- 


32 


space 


68 


D 


135 


READ 


171 


— 


33 


1 


69 


E 


136 


LET 


172 




34 




70 


F 


137 


GOTO 


173 


/ 


35 


-4- 


71 


G 


138 


RUN 


174 


I 


36 


$ 


72 


H 


139 


IF 


175 


AND 


37 


% 


73 


1 


140 


RESTORE 


176 


OR 


38 


& 


74 


J 


141 


GOSUB 


177 


> 


39 




75 


K 


142 


RETURN 


178 


= 


40 


( 


76 


L 


143 


REM 


179 


< 


41 


) 


77 


M 


144 


STOP 


180 


SGN 


42 




78 


N 


145 


ON 


181 


INT 


43 


+ 


79 





146 


WAIT 


182 


ABS 


44 




80 


P 


147 


LOAD 


183 


USR 


45 


— 


81 


Q 


148 


SAVE 


184 


FRE 


46 




82 


R 


149 


VERIFY 


185 


POS 


47 


/ 


83 


S 


150 


DEF 


186 


SQR 


48 





84 


T 


151 


POKE 


187 


RND 


49 


1 


85 


U 


152 


PRINT ^ 


188 


LOG 


50 


2 


86 


V 


153 


PRINT 


IfK 


EXP 


51 


3 


87 


w 


154 


CONT 


190 


COS 


52 


4 


88 


X 


155 


LIST 


191 


SIN 


53 


5 


89 


Y 


156 


CLR 


192 


TAN 


54 


6 


90 


Z 


157 


CMD 


193 


ATN 


55 


7 


91 


I 


158 


SYS 


194 


PEEK 


56 


8 


92 


X 


159 


OPEN 


195 


LEN 


57 


9 


93 


] 


160 


CLOSE 


196 


STR$ 


58 




94 


I 


161 


GET 


197 


VAL 


59 




95 


*- 


162 


NEW 


198 


ASC 


60 


< 


96-127 


Unused 


163 


TAB( 


199 


CHR$ 


61 


= 


128 


END 


164 


TO 


200 


LEFTS 


62 




129 


FOR 


165 


FN 


201 


RIGHTSS 


63 


? 


130 


NEXT 


166 


SPC( 


202 


MID$ 


64 




131 


DATA 


167 


THEN 


203-254 


Unused 


65 


A 


132 


INPUT 


168 


NOT 


255 


77 



Note that the left parenthesis is stored as part of the one-byte token 
for functions TAB and SPC, however, the other functions use a 
separate byteforthis synnbol. Forexannple, the line: 

10 IF INT(A) <5THEN PRINTTAB(X) 



would be coded as the following bytes (in decinnal): 



Link 


10 





139 


32 


181 


40 


65 


41 


179 


53 


32 


167 


32 


153 


32 


163 


88 


41 






Line i 
Nunnber IF 



i 

INT 



< 



1 1 I X ) 

THEN PRINT TAB( 
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between commands which share the first two letters, as in the STOP 
and STEP. In these cases the first two letters should be typed followed 
by the third with the shift key depressed. Table 2 is a list of Basic 
commands and their abbreviated form with the numerical value of the 
command token in both decimal and hexadecimal. 

The token value given to a Basic command is a pointer into a table of 
reserved command words located between 49310 and 49566. By 
subtracting 127 from the token value the number of the word in that 
table can be obtained. It should be noted that the technique of using 
tokens to represent words can give the programmer a ven/ powerful 
method of generating print statements without consuming a large 
amount of memon/. This can prove especially useful in games 
programs, such as Adventure, which require a lot of text generation. A 
table of, say, 200 common words is constructed and each time one of 
these words appears in a print statement it is represented by a 
number pointing to its location in the table. Obviously some sort of 
output subroutine is required to convert the token back into a word 
but the saving in memon/ space can be considerable, especially if 
done using machine code routines. 

Having converted the Basic command into a single byte token the 
line is stored together with the line number and a link address at a 
location just above that of the last line entered. Assuming it is the first 
line of a program being entered on a standard VIC, then it will be 
entered into the following locations using the following format. 

4096 — contents 

4097 — link address low > 

I points to starting 
I location of next line 

4098 — link address high ' 

4099 — line number low 
4100 — line number high 

4101 — start of compressed Basic text. 

Number of bytes occupied variable. 
End of line flagged by a zero byte. 

A Basic program is stored as a series of blocks each of variable 
length and representing one line in the program. Each block having a 
fixed format and all blocks being connected via a linked list structure. 
Each line in a program is stored in memon/ in the correct position 
dictated by the magnitude of its line number, thus it will be the line 
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Fig. 9 — How a Basic program is stored in memory. 
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with the lowest number which is stored at the bottom of memory — 
location 4097 up. The line number is stored in byte 3 and 4 of a block in 
binary format. This means that the largest line number that can be 
used in a program is 65535, any number above that will give a syntax 
error. When a program is run the current line number being executed 
is stored in locations 57 and 58. A direct mode of operation for the 
processor is indicated when the contents of these two bytes is zero. 
The double byte link address points to the starting byte of the next 
line. As each line is executed this address is stored in locations 122 
and 123, where it is accessed when the operating system fetches the 
next line. The link address of the last line of a program points not to 
another link address as in a normal program line, but to two bytes the 
contents of which are zero. The storage of a program within memon/ 
is best illustrated by the diagram in Figure 9. 

A knowledge of how a program is stored in memon/ is useful, 
enabling several operations not otherwise allowed by the system to 
be performed; line renumbering, program margins and overlays. Line 
numbers can be changed simply by changing the contents of bytes 
three and four of each block (line). The beginning of each line is 
located using the link address obtained from the previous line. It 
should be noted however that th's will not renumber any of the jump 
addresses stored in the Basic text. To do this the program must 
examine the tokens used in the Basic text area, looking for GOTO or 
GOSUB commands and renumber their jump addresses. Whereas the 
line number is stored in a binan/ format the jump line number is stored 
in ASCII and is thus of variable length. 
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DATA STORAGE 

The entire area of memory not used for program storage is available 
for storage of data. Firstly, it is worth looking at the simplest form of 
data storage — using data statements. A data statement is stored as 
part of a program in the Basic text area of memon/. The data is 
accessed by the program using the READ command. Data stored in 
data statements can only be added to by adding program lines. 
Another limitation is that data can only be accessed from data 
statements in a serial mode, meaning that to find one particular item 
the whole table of data must be read. The pointer to the current data 
statement is stored in locations 65 and 66 and the data line in 63 and 
64. Manipulation of the contents of these locations could provide the 
user with a means of overcoming the serial search limitation. 

Data not stored within the program as data statements, is stored by 
the program in the area of memon/ above the Basic text area, as 
variables. Variables can be divided into two groups. Simple variables 
of the kind used in the following statement; LET X = 47 where X is a 
simple variable. Array variables are defined by a DIM statement and 
contain more than one value. The number of values is determined by 
the number of elements in the DIM statement. For both groups of 
variables there are three types of data — real or floating point 
numbers — integer numbers — and character or string variables, 
(where words are being stored rather than numbers). 

Simple vanables of whatever data type are stored immediately 
above the Basic program text area, at an address pointed to by the 
contents of locations 45 and 46. The amount of memon/ used to store 
these variables depends on the number of variables used by a 
program. Each variable occupies seven bytes of memon/ and the next 
free location in the simple variable storage area is pointed to by the 
contents of locations 47 and 48. 

The array variables are stored above the simple variables and thus 
start from the location pointed to by 47 and 48. The amount of 
memon/ used to store the array variables depends on the number of 
array variables, the number of elements in each and the data type of 
each variable. The end of the storage area used for array variables 
which is also the beginning of the unused storage area of memon/, is 
pointed to by locations 49 and 50. Since array variables are stored 
directly above simple variables, whenever a new simple variable is 
encountered in a program, the operating system shifts the entire 
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1 

first second 

character in variable 

name (the ASCII 

value + 128) 


high low 

order byte of binary 

representation of 

integer value 












FLOATING POINT VARIABLE 



first second 


binary 


binan/ mantissa in packed 


character in variable 


exponent 


BCD giving eight digit 


name 


+ 129 


precision. First bit of first 
byte is sign bit. 



STRING VARIABLES 



first second 

character in variable 

name, 128 added to 

ASCII value of second 

character only. 


number 

of 

characters 


low high 

order byte of 

address where 

string is stored 







r 



Fig. 10 — The storage of Basic variables in memory. 
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array variable storage area up severe bytes in memory thereby 
opening up a space to accommodate the new variable. This dynamic 
re-allocation of data storage space is one of the reasons why a 
machine code subroutine can not be stored in unused memon/ space, 
unless placed above the address stored in the top of memon/ pointers 
in locations 55 and 56. The re-allocation of memon/ space slows down 
a program, even/ time a new variable is encountered processing stops 
while the data is moved. When processing speed is important, such as 
in real time applications, this rather inconsistent variation in speed 
can be a problem. It is overcome by initialising all the variables — 
using dummy constants if necessan/ - at the beginning of the 
program. 

Single value variables are divided into three distinct data types, 
each being stored in a different format. The only thing all three have in 
common is that each variable stored requires seven bytes of memon/. 
Both integer and floating point numbers stored as single value 
variables have both the name and the value stored within the seven 
bytes allocated to each variable. An integer variable is distinguished 
from a floating point variable by adding 128 to the ASCII value of the 
variable name. The formats used are shown in FigurelO. From this, one 
can see that there is no saving in memon/ usage by using single value 
integer variable instead of floating point variables. 

When the data being stored consists of a string of alphanumeric 
characters then the variable is stored using the character forn^iat. In 
this format the data is not stored within the seven bytes allocated for 
variable storage. What is stored is a pointer to an address in memon/ 
where this string of characters is stored. Character strings are in fact 
stored in an area right at the top of memon/ and extending 
downwards towards the area occupied by the array variables. By 
using this method string vanables need not be of a fixed length 
thereby considerably reducing the amount of memon/ needed to 
store them. The format used for a string variable is shown in Figure 1 0. 

Since the number of characters in the string is stored as a single 
byte it is not possible to have a character string longer that 255 
characters. This should be considered when adding two string 
variables together where both are fairly long. Though the area at the 
top of memon/ is allocated for the storage of strings, not all string 
variables are stored there. Thus all strings defined within the program 
are retrieved, when required from the program text area. This is done 
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Fig. 1 1 — The storage of Basic array variables in memory. 
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by having the variable address pointers point to the location in Basic 
text rather than the top of nnennon/. What is stored at the top of 
memon/ are calculated string variables. The area of mennon/ occupied 
by these strings can be deternnined by looking at the contents of 
locations 51 and 52 this is the start address of the string area, and 53 
and 54 which is the end address. 

The three data types encountered as simple single value variables 
can also be stored as nnultiple value or array variables. Whereas 
simple variables of whatever data type all occupy the same amount of 
memon/ for each variable, the memon/ requirement for an array is 
different for each type of data. An array is stored as; an array header 
plus a set of elements each roughly corresponding to a sirfiple 
variable. The array header contains the array name, the number of 
dimensions in the array, the number of elements in each dimension 
together with a pointer to the start of the next array. Array headers 
are the same for all data types. As with simple variables the array data 
type is coded into the array name. In a floating point array both 
characters are the normal ASCII code. In an integer array 128 is added 
to the ASCII value of both characters, and in a character array 128 is 
added to the ASCII value of the second character only. The general 
format of an array is shown in Figure IT Here N is used to designate the 
last element in an array and corresponds to the value used in the DIM 
statement at the beginning of the program when the array was 
initialised. The array header for whatever data type has the format 
shown in Figurel T 

In a one dimensional array the array header occupies seven bytes, 
but if two dimensions are specified then an extra two bytes are 
required to specify the number of elements in that dimension, making 
the header nine bytes long. Similarly if there are three dimensions it 
would be eleven bytes long. In a two dimensional array set up by DIM 
D(A, B) the number of elements in B is stored in bytes 6 and 7 of the 
header, the number of elements in A is stored in bytes 8 and 9. The 
format for each element in an array is identical since all elements are 
of the same data type, though the format is different for each data 
type, these are shown in Figurel 1. 

NOTE: a negative integer whether in an array or a simple variable is 
stored as a two's complement number, thus a negative integer 
cannot exceed 32768. 
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Programs involving extensive string manipulation can suffer from 
seemingly inexplicable and often lengthy pauses in their operation. 
This is caused by an operating system function known as garbage 
collection. Even/ time a character string is input, or calculated, it is 
stored at the bottom of the character string storage area in a string. 
To avoid running out of memon/ the system must perform at this 
point a "garbage collection" routine. Garbage collection reclaims all 
the unused memon/ and compacts the string storage at the top of 
memon/. This subroutine which is located at $D526 is lengthy and 
time consuming especially in large programs and is the main reason 
why such programs run at a much slower rate than small programs. 
One can force garbage collection to take place by performing the 
command PRE (U) which calculates the amount of free memon/ space. 
This is useful if you don't want a real time program interrupted by the 
garbage collection process. Generally the more user memon/ there is 
available in the system, coupled with extensive string manipulation in 
a program, the longer the delays caused by garbage collection. 



70 



THE BASIC AND OPERATING SYSTEM SOFTWARE 

The top 16K of memory is occupied by the system software, these 
are the programs which allow the VIC to be programmed in Basic, to 
display and input data, and communicate with peripheral devices. 
This 16K of machine code programs is very important since it defines 
the VIC as a system, the VIC hardware is very flexible and by changing 
the system software the VIC could become a totally different machine. 
There is nothing to stop the user from completely re-defining the VIC 
interfaces to conform to say Centronics standard rather than RS232, it 
just requires a change in the operating system software. Similarly the 
VIC could be converted to run any high level language instead of Basic 
simply be replacing the Basic interpreter software. This flexability is 
an extremely valuable feature of the VIC since it allows the 
programmer to re-define the system to suit a particular application. 

The 16K of system software can be divided into two distinct 
sections, the Basic interpreter and the operating system kernal. Each 
of these two sections are approximately the same length and each is 
contained on its own 8K ROM. The Basic interpreter ROM lies in 
memon/ space from address hex $0000 to $DFFF, the operating 
system kernal ROM lies from address hex $E000 to $FFFF. The 
operating system kernal is a totally self contained program and does 
not need the Basic interpreter program to function. The Basic 
interpreter however, uses the operating system routines to perform 
all 1/0 and peripheral communications functions. Both Basic and the 
operating system transfer variables between their constituent 
routines and between the two programs using the RAM space 
allocated to variables at the bottom of memon/ and processor registers 
are also used. 

In Basic most of the calculations are performed using floating point 
numbers rather than simple integers or binan/ values. Consequently 
most of the routines which perform these functions utilise one or both 
of the floating point accumulators, both are located in page zero 
memon/, they have the following format and location: 
Location 

Function 

Exponent -h $80 

Fraction MSB (binan/) 

Fraction byte 2 

Fraction byte 3 
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Ace No. 1 


Ace No, 


$61 


$69 


$62 


$6A 


$63 


$6B 


$64 


$6C 



$65 


$6D 


Fraction LSB 


$66 


$6E 


Sign (FF = — and 0=+) 


$6F 




Sign comparison byte 


$70 




Rounding byte for Ace No. 1 



The majority of routines within both Basic and the operating 
systenn can be accessed and used by other machine code programs 
requiring that function, this can greatly reduce the amount of code 
required. To use these routines one needs to know the entn/ point and 
the nature, location and format of any parameters passed between 
the routine and the calling program. The designers of the VIC have 
made it fairly easy to use 36 of the most useful routines in the 
operating system kernal, by making them accessible through a jump 
table. Other routines in the kernal and Basic are less easy to use, 
particularly in Basic since this software originated outside 
Commodore (it was originally written by Microsoft but ammended by 
Commodore). All the major system software entn/ points are listed in 
Table 3 together with a short description of the function of each 
routine. The following is a description of the most useful of these 
routines, how their parameters are passed and how they can be used 
from a user written machine code program. 
$C43A — Error Message Handling Routine 

Communication registers: message No. is in X reg. 

Description: This routine outputs an error message from the table 
of error messages, the message number is contained in the X index 
register. The error message is output to the currently open output 
device (default to screen). This is a useful way of generating error 
messages in a user program though one is limited to the standard set 
of messages. 

$C483 — Main Command Handling Routine. 

Description: This routine handles a new Basic line input from the 
keyboard and either executes it in the direct mode or stores it in 
indirect mode. This routine will be required by the programmer when 
adding extra commands to Basic. 

$C560 — Input and Place in Basic Buffer. 

Communication registers: 89 byte Basic buffer locations $0200 to 
$0258 
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NAME FUNCTION 

COOO — C045 Action addresses for primary keywords 

C046 — C073 Action addresses for functions 

C074 — C091 Hierarchy and action addresses for operators 

C092— C1 92 Table of Basic keywords 

C1 93 — C2A9 Basic nnessages, nnostly error nnessages 

C38A— C3B7 Search stack for FOR or GOSUB activity 

C3B8 — C3FA Open up space in nnennon/ 

C3FB— C407 Test: stack too deep? 

C408 — 0434 Check available nnennon/ 

0435 Send canned error nnessage, then : 

0474—0482 Print Ready 

0483 — 0532 Handle new Basic line fronn keyboard 

0533 — 055F Rebuild chaining of Basic lines in nnennon/ 

0560 — 057B Receive line fronn keyboard 

0570 — 061 2 Change keywords to Basic tokens 

0613 — 0641 Search Basic for a given Basic line nunnber 

0642 Perform NEW, then: 

0660— 068D Perform CLR 

068E — 069B Reset Basic execution to start-of-program 

0690—0741 Perform LIST 

0742— 07EC Perform FOR 

07ED — 081 G Execute Basic statement 

081 D— 082B Perform Restore 

0820—0856 Perform STOP and END 

0857—0870 Perform CONT 

0871—0882 Perform RUN 

0883— 089F Perform GOSUB 

08AC^08D1 Perform GOTO 

08D2— C8EA Perform RETURN, and perhaps: 

08EB— 0905 Perform DATA, i.e., skip rest of statement 

0906 — 0908 Scan for next Basic statement 

0909 — 0927 Scan for nextBasic line 

0928— 093A Perform IF, and perhaps: 

093B— 094A Perform REM, i.e., skip rest of line 

094B— 096A Perform ON 

096B — 09A4 Get fixed-point number from Basic 

09A5— 0A1 Perform LET 
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D11D— D193 



CA1 D— CA2B Add ASCII digit to accumulator No. 1 . 

CA2C— CA7F Continue to perform LET 

CA8(^-CA85 Perform PRINT # 

CA86— CA99 Perform CMD 

CA9A— CBl D Perform Print 

CB 1 E — CB3A Print string from memon/ 

CB3B — CB4C Pnnt single format character (space, cursor-right,?) 

CB4D— CB7A Handle bad input data 

CB7B— CBA4 Perform GET 

CBA5— CBBE Perform INPUT No. 

CBBF— CBF8 Perform INPUT 

CBF9 — CC05 Prompt and receive input 

CC06 — CCFB Perform READ; common routines used by 

INPUT and GET 

CCFC— CDl D Messages: EXTRA IGNORED, REDO FROM START 

CD1 E— CD77 Perform NEXT 

CD78— CD9D Check data type, print TYPE MISMATCH 

CD9E — CEFO Input & evaluate any expression (numeric or string) 

CEF1 — CEF6 Evaluate expression within parentheses ( ) 

CEF7 — CEF9 Check right parenthesis ) 

CEFA— CEFC Check left parenthesis ( 

CEFD — CF07 Check for comma 

CF08— CFOC Pnnt SYNTAX ERROR and exit 

CFOD — CF13 Set up function for future evaluation 

CFl 4 — CFA6 Search for variable name 

CFA7 — CFE5 Identify and set up function references 

CFE6— CFE8 Perform OR 

CFE9— DOl 5 Perform AND 

D01 6 — D07D Perform compansons, string or numeric 

D07E— D08A Perform DIM 

D08B — D1 1 2 Search for variable location in memon/ 

D1 13 — D1 1C Check if ASCII character is alphabetic 

D1 1 D — D1 93 Create new Basic variable 

D1 94 — Dl A4 Array pointer subroutine 

D1 A5— D1 A9 32768 in floating binan/ 

D1AA — D1D0 Evaluate expression for positive integer 

D1 D1— D34B Find or create array 

D34C — D37C Compute array subscript size 

D37D— D390 Perform FRE then: 

D391 — D39D Convert fixed point to floating point 

D39E— D3A5 Perform POS 

D3A6— D3B2 Check if direct command, print ILLEGAL DIRECT 
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D3B3— D3E0 Perform DEF 

D3E1— D3F3 Check FNx syntax 

D3F4— D464 Evaluate FNx 

D465— D474 Perform STR$ 

D475— D486 Calculate string vector 

D487 — D4F3 Scan and set up string 

D4F4 — D525 Subroutine to build string vector 

D526 — D5BC Garbage collection subroutine 

D5BD — D605 Check for most eligible string collection 

D606— D63C Collect a string 

D63D — D679 Perform string concatenation 

D67A— D6A2 Build string into memon/ 

D6A3— D6DA Discard unwanted string 

D6DB — D6EB Clean the descriptor stack 

D6EC— D6FF Perform CHR$ 

D700— D72B Perform LEFTS 

D72C— D72C Perform RIGHTS 

D737— D760 Perform MIDS 

D761 — D77B Pull string function parameters from stack 

D77C— D781 Perform LEN 

D782 — D78A Move from string-mode to numeric-mode 

D78B— D79A Perform ASC 

D79B— D7AC Input byte parameter 

D7AD— D7EA Perform VAL 

D7EB— D7F6 Get two parameters for POKE or WAIT 

D7F7 — D80C Convert floating point to fixed point 

D80D— D823 Perform PEEK 

D824— D82C Perform POKE 

D82D— D848 Perform WAIT 

D849— D84F Add 0.5 to accumulator No. 1 . 

D850— D861 Perform subtraction 

D862— D946 Perform addition 

D947 — D97D Complement accumulator No. 1 

D97E— D982 Print OVERFLOW and exit 

D983— D9BB Multiply-a-byte subroutine 

D9BC— D9E9 Function constants: 1 , S0R(.5), S0R(2), -00.5. etc. 

D9EA— DA2F Perform LOG 

DA30— DA58 Perform multiplication 

DA59— DA8B Multiply-a-bit subroutine 

DA8C — DAB6 Load accumulator No. 2 from memon/ 

DAB7— DAD3 Test and adjust accumulators No. 1 and No. 2. 

DAD4 — DAE1 Handle overflow and underflow 
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DAE2— DAF8 Multiply by 10 

DAF9— DAFD 1 in floating binan/ 

DAFE— DB06 Divide by 10 

DB07— DB1 1 Perfornn divide-into 

DB12— DBA1 Perform divide-by 

DBA2 — DBC6 Load accunnulator No. 1 from memon/ 

DBC7 — DBFB Store accumulator No. 1 into memon/ 

DBFC — DCOB Copy accumulator No. 2 into accumulator No. 1 . 

DCOC — DC1A Copy accumulator No. 1 into accumulator No. 2. 

DC1 B— DC2A Round off accumulator No. 1 . 

DC2B— DC38 Compute SGN value of accumulator No. 1 . 

DC39— DC57 Perform SGN 

DC58— DC5A Perform ABS 

DC5B — DC9A Compare accumulator No. 1 to memon/ 

DC9B — DCCB Convert floating-point to-fixed-point 

DCCC— DCF2 Perform INT 

DCF3 — DD7D Convert string to floating-point 

DD7E— DDB2 Get new ASCII digit 

DDB3— DDC1 Stnng conversion constants: 99999999,999999999 

1EH-9 

DDC2 Pnnt IN, followed by: 

DDCD— DDDC Pnnt Basic line number 

DDDD— DF10 Convert number orTI$ to ASCII 

DF1 1 — DF70 Constants for numeric conversion 

DF71— DF77 Perform SQR 

DF78 — DFB3 Perform power function 

DFB4— DFBE Perform negation 

DFBF — DFEC Constants for string evaluation 

DEED— E03F Perform EXP 

E040 — E089 Function series evaluation subroutines 

E08A— E093 Manipulation constants for RND 

E094— E0F5 Perform RND 

E0F6 — E260 Kernal patch routines (see Appendix 6 for listings) 

E261— E267 Perform COS 

E268— E2B0 Perform SIN 

E2B1— E2DC Perform TAN 

E2DD— E30A Constants for trig evaluation pi/2, 2No.pi, .25, etc. 

E30B— E33A Perform ATN 

E33B — E377 Constants for ATN series evaluation 

E378— E386 Initialise RAM vectors 

E387— E3A3 Subroutine to be moved to zero page ($70 to $87) 

E3A4— E428 Initialise Basic system 
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E429— E44E Messages: BYTES FREE, **** CBM BASIC 

\/9 "^ "^ "^ "^ 

E44F — E47B Vector initialisation (see Appendix 6 for listings) 

E47C— E4FF Unused space 

KERNAL ROUTINES 

E500— E504 Return address of 6522 

E505 — E509 Return max rows and columns of screen 

E50A — E51 7 Read/plot cursor position 

E518— E580 Initialise I/O 

E581 — E586 Home function 

E587 — E5B4 Move cursor to current line index pointer 

E5B5— E5C2 Panic NMI entry (Restore key) 

E5C3— E5CE Initialise 6561 VIC chip 

E5CF — E64E Remove character from queue 

E64F — E741 Input a line until carriage return 

E742— E8E7 Pnnt routine 

E8E8 — E8F9 Check for decrement in line index pointer 

E8FA — E91 1 Check for increment in line index pointer 

E912— E928 Check colour 

E929 — E974 Table to convert from screen code to ASCII 

E975 — EAAO Screen scroll routines 

EAA1 — EBID IRQ routines, put char on screen and update time, 

generate I/O 

EBIE — EC45 General keyboard scan 

EC46 — EE13 Keyboard matrix tables 

EE14 — EEBF Command serial bus device to listen 

EECO — EEC4 Send secondan/ address after listen 

EEC5 — EECD Release attention after listen 

EECE — EEE3 Talk second address 

EEE4 — EEF5 Buffered output to serial bus 

EEF6 — EF03 Send untalk command on serial bus 

EF04 — EF18 Send unlisten command on serial bus 

EF1 9 — EFA2 Input a byte from serial bus 

EFA3— EFED NMI continue routine 

EFEE— F035 Transmit byte 

F036— F1 73 NMI routine to collect data into bytes (RS-232) 

F1 74 — F1 El Kernal messages 

F1 E2 — F1 F4 Print message to screen 

F1 F5 — F20D Get character from channel 

F20E — F279 Input character from channel 
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F27A- 


-F2C6 


Output character to channel 


F2C7- 


-F308 


Open channel for input 


F309- 


-F349 


Open channel for output 


F34A- 


-F3EE 


Close logical file 


F3EF- 


-F3F2 


Close all logical files 


F3F3- 


-F409 


Clear channels 


F40A- 


-F541 


Open function 


F542- 


-F674 


Load RAM function (from cassette or bus devices^ 


F675- 


-F733 


Save function 


F734- 


-F76F 


Time function 


F770- 


-F77D 


Test stop key 


F77E- 


-F7AE 


Error handler 


F7AF- 


-F889 


Find and read tape header 


F88A- 


-F98D 


Cassette control routines 


F98E- 


-FABC 


Tape read routines 


FABD- 


-FBE9 


Byte handler for cassette read 


FBEA- 


-FD21 


Tape write routines 


FD22- 


-FE90 


System power up initialisation 


FE91- 


-FEA8 


Memory check routines 


FEA9- 


-FF5B 


NMI handler 


FF5C- 


-FF71 


Baud rate tables 


FF72- 


-FF85 


IRQ handler 


FF85- 


-FFFF 


Kernal jump vector addresses 
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Description: Data strings up to 88 characters long are input by this 
routine and stored in the Basic input buffer. The buffer is filled starting 
at location $0200 upwards, end of string ternninated by a zero byte. 

$C57C — Tokenise Basic Connnnand. 

Description: Basic connnnands are converted to single byte tokens 
by this routine, reducing nnennon/ requirennents for progrann storage. 
Routine required when adding connnnands to Basic. 

$CBI E — Print String Pointed to by Y, A 

Connnnunication registers: Y index and Accunnulator. 

Description: A data string is printed on the current output device, 
default device is the screen. The memory address of the start of the 
string is pointed to by the contents of the Y index register (LSB of 
address) and the Accunnulator (MSB of address). The end of the string 
is the first byte encountered containing a binan/ zero. 

$CE86 — Evaluate Expression. 

Connnnunication registers: Page Zero $7A and $7B plus Stack and Aces 
No. 1 and No. 2 

Description: This routine evaluates a Basic expression starting at 
an address stored in locations $7A (LSB of address and $7B (MSB of 
address). The result is stored in Accunnulator No. 1 . 

$CFE6 — Logical OR between contents of Ace No. 1 and Ace No. 2. 

Connnnunication registers: Floating point Accunnulators No. 1 and No. 
2. 

Description: A logical OR is perfornned between values contained in 
the two floating point accunnulators, the result is placed in 
accunnulator No. 1. 

$CFEB — Logical AND between contents of Ace No. 1 and Ace No. 2. 

Connnnunication registers: Floating point Accunnulators No. 1 and No. 
2. 
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Description: A logical AND is performed between values contained 
in the two floating point accumulators, the result is placed in 
accumulator No. 1 . 

$D1AA— Convert Floating Point Number to Integer. 
Communication registers: Floating point Accumulator No. 1 . 

Description: A number in floating point format stored in 
Accumulator No. 1 is converted by this routine to a double byte 
integer stored in two bytes of Accumulator No. 1 . The two bytes used 
are $64 and $65, the format of the integer number is 1 00^ $64 + $65. 

$D37D — Perform FRE function. 

Communication registers: Floating Accumulator No. 1. 

Description: This function determines the number of free bytes of 
memon/ available in the system for user program or data storage. The 
arguments of the function are stored and returned as a floating point 
number in Accumulator No. 1 . 

$D391 — Integer to Floating Point conversion. 

Communication registers: Y index register, Accumulator, and 
Floating Accumulator No. 1 . 

Description: A two byte integer value stored in Y index register and 
Accumulator is converted to a floating point number stored in floating 
accumulator No. 1. The integer value is stored in the format — 100 "^ 
accumulator + Y index register. 

$D77C— Perform LEN function. 

Communication registers: X index register, and Floating accumulator 
No. 1. 

Description: This routine calculates the number of characters in a 
stnng, the argument of the function, ie. the string name, is stored in 
bytes $64 and $65 of floating accumulator No. 1. The string length is 
returned in the X index register. 
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LOOP RETURN ADDRESS 



RETURN LINE No 



TO VALUE 



SIGN OF STEP 



STEP VALUE 



VARIABLE'S ADDRESS 



$81 



FOR -NEXT 



— 


$F6FC 






— 


RETURN 


ADDRESS 


— 


RETURN 


LINE 


No 


$8D 



GO -SUB 



Fig. 12 — Stack usage by two Basic interpreter routines. 
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$D850 — Subtract Ace No. 2. from Ace No. 1 . 

Communication registers: Floating Accumulators No. 1 and No. 2. 
and Accumulator. 

Description: The contents of floating point accumulator No. 2. is 
subtracted from the contents of floating accumulator No. 1. by this 
routine, the result being stored in accumulator No. 1. Before this 
routine is called the sign comparison byte $6F must be set, this is done 
by exclusively ORing the contents of $66 and $6E and storing the 
result in $6F, the processor accumulator should also contain the value 
stored in location $61 (MSB of Ace No. 1 .). 

$D9EA— Perform LOG function. 

Communicating registers: Floating point accumulator No. 1. 

Description: This routine performs the LOG function, the value used 
in the functions argument is stored in floating accumulator No. 1. the 
result IS placed in the same accumulator. 

$DA30 — Multiply Floating Point Number in Memon/ by Ace No. 1 . 

Communicating registers: Floating point accumulators No. 1 and No. 
2., accumulator and Y index register. 

Description: This routine first obtains the contents of floating 
accumulator No. 2 from memon/. The memon/ location is a two byte 
address stored in the processor accumulator and Y index register, the 
format used is 100 "" Y index -f accumulator. The value stored in 
accumulator No. 2. is then multiplied by the contents of accumulator 
No. 1 and the result stored in accumulator No. 1 . 

$DA33 — Multiply Ace No. 2. by Ace No. 1 . 

Communicating registers: Floating point accumulators No. 1. and No. 
2. and processor accumulator. 

Description: The contents of floating point accumulator No. 2. is 
multiplied by the contents of accumulator No. 1., and the result stored 
in accumulator No. 1. Before using this routine the sign comparison in 
$6F should be set, this is done by exclusively ORing the contents of 
the two sign bytes $66 and $6E and storing the result in $6F. The 
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exponent of the value in accunnulator No. 1., stored in $61, should be 
loaded into the processor accunnulator prior to running this routine. 

$DA8C — Move Contents of Mennon/ to Ace No. 2. 

Connnnunicating registers: Floating point accumulator No. 2., 
processor accumulator and Y index register. 

Description: This routine takes a value stored in memon/ and loads 
it into floating point accumulator No. 2. The two byte memon/ 
address for the value is stored in the processor accumulator and Y 
index register, the format used is accumulator + 100 "" Y index 
register. The routine seperates the sign byte and sets the sign 
comparison byte, the contents of $61, the exponents of accumulator 
No. 1 are loaded into the processor accumulator. 

$DAE2 — Multiply Accumulator No. 1 by 1 0. 

Communicating registers: Floating Point Accumulators No. 1 and No. 
2. 

Description: The contents of floating point accumulator No. 1 is 
multiplied by 10 and the result is stored in floating point accumulator 
No. 2. 

$DAFE — Divide Accumulator No. 1 . by 1 0. 

Communicating registers: Floating Point Accumulators No. 1 and No. 
2. 

Description: The contents of floating point accumulator No. 1 is 
divided by 10 and the result is stored in floating point accumulator No. 
2. 

$DBOF — Divide accumulator No. 2. by Accumulator No. 1 . 

Communicating registers: Floating Point Accumulators No. 1 and No. 
2. 

Description: This routine divides the contents of accumulator No. 2. 
by the contents of accumulator No. 1. and puts the result in 
accumulator No. 1. Before running this routine the sign comparison in 
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$6F should be set, this is done by exclusively ORing the contents of 
the two sign bytes $66 and $6E and storing the result in $6F. The 
exponent of the value in accunnulator No. 1,, stored in $61, should be 
loaded into the processor accunnulator prior to running this routine. 

$DBA2 — Move Contents of Mennon/ to Ace No. 1 . 

Connnnunicating registers: Floating Point Accunnulator No. 1., 
processor accunnulator and Y index register. 

Descnption: This routine takes a value stored in nnemon/ and loads 
it into floating point accunnulator No. 1. The two byte nnennon/ 
address for the value is stored in the processor accunnulator and Y 
index register, the fornnat used is accunnulator -i- 100 * Y index 
register. The routine seperates the sign byte and sets the sign 
connparison byte, the contents of $61, the exponents of accunnulator 
No. 1 , is loaded into the processor accunnulator. 

$DBC7 — Move Contents of Accunnulator No. 1 . to Mennon/. 

Connnnunicating registers: Floating Point accumulator No. 1. X and Y 
index registers. 

Description: The value in floating point accunnulator No. 1. is stored 
in a specified nnennon/ location by this routine. The two byte nnennon/ 
address is stored in the X and Y processor index registers, the fornnat 
used is X index -f 100 * Y index register. The routine nnerges the sign 
byte to give the correct nnennon/ storage format (the first bit of first 
byte = sign). 

$DBFC — Transfer Contents of Ace No. 2. to Ace No. 1 . 

Connmunicating registers: Floating Point Accumulators No. 1. and 
No. 2. 

Description: The current contents of floating point accumulator No. 
2., are copied into accumulator No. 1 ., the contents of accumulator No. 
2 remain unchanged. 

$DCOC — Transfer Contents of Ace No. 1., to Ace No. 2. with 
Rounding. 
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Communicating registers: Floating Point Accumulators No. 1. and 
No. 2. 

Description: The contents of floating point accumulator No. 1., are 
copied into accumulator No. 1., the contents of accumulator No. 1 ., are 
then rounded and if necessan/ the exponent adjusted. 



$DCOF — Transfer Contents of Ace No. 1 ., to Ace No. 2. 

Communicating registers: Floating Point accumulators No. 1., and 
No. 2. 

Description: The contents of floating point accumulator No. 1., are 
copied into accumulator No. 2., the contents of accumulator No. 1 ., are 
then rounded and if necessan/ the exponent adjusted. 



$DC58 — Performs ABS function. 

Communicating registers: Floating Point Accumulator No. 1. 

Description: The absolute value of the contents of floating point 
accumulator No. 1 . are returned to accumulator No. 1 by this routine. 



$DC39 — Perform SON function. 

Communicating registers: Floating Point Accumulator No. 1. 

Description: This routine returns the sign of a value stored in 
floating point accumulator No. 1. If the value in accumulator No. 1., is 
greater than then a 1 is stored in accumulator No. 1., if it equals zero 
then a 0, and if less than zero then a — 1 . 



$DC5B — Compare Contents of Ace No. 1 ., to Memon/. 
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Communicating registers: Floating Point Accumulator No. 1., 
processor accumulator and Y index register. 

Description: The current contents of floating point accumulator No. 
1 ., are compared to a floating point variable stored in memon/, and the 
processor accumulator set to a value dependant on whether the two 
variables are equal or not. The two byte address for the floating point 
variable in memon/ is stored in the processor accumulator and the Y 
index register, the format used is accumulator -f 100 "^ Y index. If the 
two floating point variables are equal then the processor accumulator 
is set to $00, and if not equal then it is set to $FF. 
$DC9B — Convert Floating Point Variable to Fixed Point. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: A floating point variable stored in accumulator No. 1., 
is converted to a fixed point format by this routine, the fixed point 
value is stored in accumulator No. 1 . 

$DCCC — Perform INT function. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: This routine converts a floating point variable stored in 
accumulator No. 1., into an integer value, the result is stored back in 
accumulator No. 1. 

$DF71 — Perform SQR function. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: The square root of a floating point variable stored in 
accumulator No. 1., is calculated by this routine, the result also in 
floating point format is returned in accumulator No. 1 . 

$DF78 — Raise Ace No. 2., to the power of Ace No. 1 . 

Communicating registers: Floating Point Accumulators No. 1., and 
No. 2. 

Descnption: The contents of floating point accumulator No. 2., is 
raised to the power of a value stored in accumulator No. 1., the result 
is placed in accumulator No. 1 . Before using this routine the sign 
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comparison in $6F should be set, this is done by exclusively ORing the 
contents of the two sign bytes $66 and $6E and storing the result in 
$6F. The exponent of the value in accunnulator No. 1., stored in $61, 
should be loaded into the processor accunnulator prior to running this 
routine. 

$DFED — Perfornn the EXP function. 

Communicating registers: Floating Point Accumulator No. 1. 

Description: This routine calculates 'e' to the power of the value in 
floating point accumulator No. 1., and places the result in 
accumulator No. 1. 

$E094 — Perform the RND function. 

Communicating registers: Floating Point Accumulator No. 1, plus 
page zero locations $8B to $90. 

Description: A random value is created by this routine and placed in 
floating point accumulator No. 1. Prior to running the routine floating 
point accumulator No. 1., contains a seed value used to initialise the 
random number calculation routine, also memon/ locations $8B to 
$90 contain the last random number generated. 

$E261 — Perform COS function. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: The COSine of a value, in radians, stored in floating 
point accumulator No. 1., is calculated by this routine and the result 
placed in accumulator No. 1 . 

$E268— Perform SIN function. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: This routine calculates the SINe of a value, in radians, 
stored in floating point accumulator No. 1., the result is placed in 
accumulator No. 1. 

$E2B1 — Perform TAN function. 
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Communicating registers: Floating Point Accumulator No. 1. 

Description: This routine calculates the TAN of a value, in radians, 
stored in floating point accumulator No. 1., the result is placed in 
accumulator No. 1. 

$E30B — Perform ATN function. 

Communicating registers: Floating Point Accumulator No. 1 . 

Description: This routine calculates the ATN of a value, in radians, 
stored in floating point accumulator No. 1., the result is placed in 
accumulator No. 1 . 

$E378 — Initialise System Vectors and Variables. 

Communicating registers: none. 

Description: All system vectors and variables are initialised by this 
routine, it can be used together with its constituent subroutines to 
reinitialise system variables and vectors prior to returning to a Basic 
program from machine code. 
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USER CALLABLE KERNAL ROUTINES 



NAME 


ADDRESS 


FUNCTION 




HEX 


DECIMAL 




ACPTR 


$FFA5 


65445 


Input byte from serial port 


CHKIN 


$FFC6 


65478 


Open channel for input 


CHKOUT 


$FFC9 


65481 


Open channel for output 


CHRIN 


$FFCF 


65487 


Input character from channel 


CHROUT 


$FFD2 


65490 


Output character to channel 


CIOUT 


$FFA8 


65448 


Output byte to senal port 


CLALL 


$FFE7 


65511 


Close all channels and files 


CLOSE 


$FFC3 


65475 


Close a specified logical file 


CLRCHN 


$FFCC 


65484 


Close input and output channels 


GETIN 


$FFE8 


65512 


Get character from keyboard queue 
(keyboard buffer) 


lOBASE 


$FFF3 


65523 


Returns base address of I/O devices 


LISTEN 


$FFB1 


65457 


Command devices on the senal bus 
to LISTEN 


LOAD 


$FFD5 


65493 


Load RAM from a device 


MEMB0T$FF9C 


65436 


Read/set the bottom of memory 


MEMTOP $FF99 


65433 


Read/set the top of memon/ 


OPEN 


$FFCO 


65472 


Open a logical file 


PLOT 


$FFFO 


65520 


Read/set X, Y cursor position 


RDTIM 


$FFDE 


65502 


Read real time clock 


READST 


$FFB7 


65463 


Read I/O status word 


RESTOR 


$FF87 


65415 


Restore default I/O vectors 


SAVE 


$FFD8 


65496 


Save RAM to device 


SCNKEY 


$FF9F 


65439 


Scan keyboard 


SCREEN 


$FFED 


65517 


Return X, Y organisation of scree 


SECOND 


$FF93 


65427 


Send secondary/ address 
after LISTEN 


SETLFS 


$FFBA 


65466 


Set logical, first, and second 
addresses 


SETMSG 


$FF90 


65424 


Control KERNAL messages 


SETNAM 


$FFBD 


65469 


Set file name 


SE^IM 


$FFDB 


65499 


Set real time clock 


SE^MO 


$FFA2 


65442 


Set timeout on serial bus 


STOP 


$FFE1 


65505 


Scan stop key 


TALK 


$FFB4 


65430 


Command serial bus device to TALK 


TKSA 


$FF96 


65430 


Send secondary address after TALK 


UDTIM 


$FFEA 


65514 


Increment real time clock 


UNTLK 


$FFAB 


65451 


Command senal bus to UNTALK 


VECTOR 


$FF84 


65412 


Read/set vectored I/O 
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USER CALLABLE KERNAL ROUTINES 

The VIC operating system software has been specially designed to 
allow the easy access of subroutines within it. These subroutines can 
be used by a nnachine code routine calling either a ROM or RAM based 
vector address. The required variables having been previously passed 
to the subroutine via the processor registers. The nnain block of kernal 
vector addresses are stored at the top of ROM mennon/, a list is shown 
in Table 4. The snnaller nunnber of RAM vector addresses are stored in 
page three of nnennon/ and a list of these is shown in Table 1 . The 
reason why sonne vector junnp addresses are stored in RAM is that 
they can be changed. By changing the vector addressed, routines 
controlling the systenn I/O and interrupt handling can be 
reconfigured. It should be noted that all the RAM vectors, except the 
interrupt handlers, point to routines which are also pointed to be 
ROM vectors. The following is a detailed description of each of the 
vector subroutines together with their function and use. 

$FF8A— Restore Old I/O Vectors. 

Connnnunicating registers: none. 
Error Returns: none. 
Stack Requirennents: 2. 
Preparaton/ routines: none. 

Description: Restore default vector values for systenn subroutines 
and interrupts. 

$FF8D — Read and Set Vectored I/O. 

Connnnunicating registers: X and Y index registers. 
Error Returns: none. 
Stack Requirennents: 2. 
Preparaton/ routines: none. 

Description: If this routine is called with the earn/ bit set, it will then 
read the current contents of the RAM vectors and put thenn in a list 
starting at a nnennon/ location pointed to by (X, Y). When this routine 
is called with earn/ clear, the user list pointed at by (X, Y) is transferred 
to the systenn RAM vectors. When using this routine the best practice 
is to read first the entire contents of the vector table into a user 
nnennon/ area, alter the desired vectors, then ennpy the contents back 
into the systenn. 
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$FF90 — Control Kernal Messages. 

Communicating registers: processor accumulator. 
Error Returns: none. 
Stack Requirements: 2. 
Preparaton/ routines: none. 

Description: This routine controls the printing of error and 
diagnostic messages by the kernal. It is called by placing a value in the 
accumulator. Bits 6 and 7 of this value control the message printing, 
bit 7 is set for kernal messages, and bit 6 for control messages. Bits 
to 5 designate the message, and point to an entn/ in the error message 
tables. 

$FF93 — Transmit Secondan/ Command. 

Communicating registers: processor accumulator. 
Error Returns: see routine $FFB7. 
Stack Requirements: 
Preparaton/ routines: $FFB1 

Description: Sends a secondan/ address after 'listen' routine $FFB1. 
This routine cannot be used to send a secondan/ address after a 'talk' 
command from routine $FFB4. 

$FF96 — Transmit Secondary After 'Talk'. 

Communicating registers: processor accumulator. 
Error Returns: see routine $FFB7. 
Stack Requirements: 
Preparaton/ routines: $FFB4 

Description: Sends a secondan/ address for 'talk'. By loading the 
accumulator with a number between and 31, the user sends a 
secondan/ address command over the IEEE with this subroutine. This 
routine can only be used after $FrB4, it will not work after $FFB1. 

$FF99 — Read/Set Top of Memon/. 

Communicating registers: X and Y index registers. 
Error Returns: none. 
Stack Requirements: 2. 
Preparaton/ routines: none. 

Description: When this routine is called with cam/ set, the pointer 
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to the top of RAM is read into .X and .Y. A call with earn/ clear will copy 
the contents of .X and .Y into this pointer. 

$FF9C — Read/Set Bottonn of Mennon/. 

Communicating registers: X and Y index registers. 
Error Returns: none. 
Stack requirements: 2. 
Preparaton/ routines: none. 

Description: A call to this routine with the cam/ bit set, causes the 
pointer to the bottom of RAM to be read into .X and .Y. The initial 
value is always $400. If the routine is called with cam/ clear then the 
contents of .X and .Y are transfered to the bottom of memon/ 
pointers. 

$FF9F — Scan Keyboard. 

Communicating registers: none. 
Error Returns: none. 
Stack Requirements: 
Preparatory routines: none. 

Description: This routine scans the keyboard, if a key is down, its 

corresponding ASCII code value is placed in the keyboard queue 

($0277 to $0280). This is the same routine called by the interrupt 
handling routines even/ 1 /60 second. 

$FFA2 — Set Timeout on IEEE. 

Communicating registers: processor accumulator. 
Error Returns: none. 
Stack Requirements: 2. 
Preparaton/ routines: none. 

Description: When the processor accumulator contains a in bit 7, 
timeouts are enabled by this routine. A 1 in bit 7 disables timeouts. 
Timeouts are a method by which the VIC can poll an IEEE device for 
data without hanging in a timeshake sequence. The device must 
respond to DAV within 64 milliseconds. The VIC and CBM disks use 
the timeout to communicate a 'file not found' status in the OPEN 
command. 
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$FrA5 — Input byte from IEEE Bus. 

Communicating registers: processor accumulator. 

Error Returns: see routine $FFB7. 

Stack requirements: 13. 

Preparaton/ routines: $FFB4 and $FF96. 

Description: This routine handshakes a byte off the IEEE bus. The 
data is returned in the processor accumulator. It is assumed that the 
device has been told to 'talk' by routine $FFB4 and it is possible that a 
secondan/ address has been sent by the routine $FF96. 

$FFA8 — Output Byte to IEEE Bus. 

Communicating registers: processor accumulator. 

Error Returns: see routine $FFB7. 

Stack Requirements: 

Preparaton/ routines: $FFB1 and$FF93. 

Description: The accumulator is loaded with a byte of data to 
handshake onto the IEEE bus. A device must be listening or status will 
show a timeout error (see routine $FFA2). One character is always 
buffered by this routine. When an 'unlisten' command is sent (by 
routine $FFAE), the buffered character is sent with the EOl line 
asserted, the 'unlisten' command is then sent. 

$FFAB — Command IEEE Bus to 'Untalk'. 

Communicating registers: none. 
Error Returns: none. 
Stack Requirements: 
Preparaton/ routines: none. 

Descnption: This sends an 'untalk' command to an IEEE device via 
the IEEE bus. 

$FFAE — Command IEEE Bus to 'Unlisten'. 

Communicating registers: none. 
Error returns: none. 
Stack Requirements: 
Preparatoray routines: none. 

Description: This sends an 'unlisten' command to an IEEE device via 
the IEEE bus. 
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$FFB1 — Command IEEE Device to 'Listen'. 

Communicating registers: processor accumulator. 
Error Returns: see routine $FFB7. 
Stack Requirements: 
Preparatory routines: $FFB1 

Description: The IEEE command 'listen with attention' is performed 
by this routine. The processor accumulator is loaded with a device 
number between and 30. This subroutine then ORs in bits to convert 
the device number to a 'listen' address and then transmits this data as 
a command on the IEEE bus. 

$FFB4 — Command IEEE Device to 'Talk'. 

Communicating registers: processor accumulator. 
Error Returns: see routine $FFB7. 
Stack Requirements: 
Preparatory routines: none. 

Description: The IEEE command 'talk with attention' is performed 
by this routine. The processor accumulator is loaded with a device 
number betwen and 30. This subroutine ORs in bits to convert the 
device number into a 'talk' address and then transmits this data as a 
command on the IEEE bus. 

$FFB7 — Read 1/0 Status Word. 

Communicating registers: processor accumulator. 
Error Returns: none. 
Stack Requirements: 2 
Preparaton/ routines: none. 

Description: Returns the current I/O status. Usually checked after 

initiating any new communication to a channel. The bits in the byte 
returned contain the following data: 

ST ST Cassette lEEE/RW Tape 

Bit Numeric Read Verify 

Position Value + Load 

1 Timeout/write 

1 2 Timeout/read 

2 4 Short block Short block 

3 8 Long block Long block 

4 16 Unrecoverable Any mismatch 
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read error 






5 


32 


Checksunn error 




Checksunn error 


6 


64 


End of file 


EOlline 




7 


128 


End of tape 
present 


Device not 


End of tape 



$FFBA — Set Logical, First, and Second Address 

Connnnunicating registers: processor accunnulator, X and Y Index 

registers:. 

Error Returns: none. 

Stack Requirennents: 2 

Preparaton/ routines: none. 

Description: Setting logical file nunnber, device address, and 
connnnand. The logical file nunnber is used as a key by the systenn to 
access data stored in a table by the open file subroutine. The device 
address ranges from to 30 and corresponds to the following VIC or 
CBM devices: 






Keyboard 


1 


Cassette No. 1 . 


2 


Cassette No, 2. (unused on VIC) 


3 


CRT display 


4 


lEEEpnnter 


8 


VICor CBM IEEE diskdnve 



Device nunnbers 4 or greater correspond to devices on the IEEE bus. 

Load the accunnulator with the logical file nunnber, X index register 
with the device nunnber, and the Y index register with the connnnand. 
The connnnand is sent as a secondan/ address on the IEEE following 
the device nunnber during an attention sequence. IF the progrannnner 
desires no secondan/ address to be sent, load Y index with a 255. 

$FFBD — Set File Nanne Infornnation. 

Connnnunicating registers: processor accunnulator, X and Y index 

registers. 

Error Returns: none. 

Stack Requirennents: 

Preparaton/ routines: none. 

Description: Should a file be opened without a file nanne, the nanne 
length nnust be set to zero. Load the accunnulator with the length, X 
index with the low order address of the file nanne and Y with the high 
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order address. The file name address can be any valid menfiory 
address where the string of characters corresponding to the file nanne 
are stored. 



$FFCO — Open Logical File. 

Connnnunicating registers: none. 

Error Returns: 1,2,4, 5 and 6. 

Stack Requirennents: 

Preparaton/ routines: $FFBA and $FFBD. 

Description: Open logical file to device. There are no argunnents to 
be set up for this routine. Both $FFBA (Set logical nunnber, device 
address and connnnand) and $FFBD (Set file nanne infornnation) nnust 
be called before calling this routine. 



$FFC3 — Close Logical File. 

Comnnunicating registers: processor accunnulator. 
Error returns: none. 
Stack Requirennents: 
Preparatory routines: none. 

Description: Close a logical file to a device. When all 1/0 to a file is 
connpleted this subroutine is called with the accunnulator loaded with 
the logical file nunnber used in the 'open' subroutine $FFCO. 



$FFC6 — Open Channel for Input. 

Connnnunicating registers: X index register. 
Error Returns: 3, 5 and 6. 
Stack Requirennents: 
Preparaton/ routines: $FFCO 



Descnption: Assunning that a file has been opened by subroutine 
$FFCO (open logical file),, it can be opened as an input channel. Of 
course the characteristics of the device will deternnine if it is valid to 
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do so. The logical file number if put in the X index register. This 
subroutine nnust be executed before subroutines $FFCF (input 
character from channel) or $FFE4 (get character from keyboard 
queue) are executed for a device other than the keyboard. If input 
from the keyboard is desired, and there is no association to the logical 
file number by a previous open file, then the call to this subroutine 
may be dispensed with. On the IEEE this subroutine results in sending 
a talk address followed by a secondan/ address if one was specified in 
the open subroutine ($FFCO). 

$FFC9 — Open Channel for Output. 

Communicating registers: X index register. 
Error Returns: 3, 5 and 7. 
Stack Requirements: 
Preparaton/ routines: $FFCO. 

Description: Assuming that a file has been opened by subroutine 
$FFCO (open logical file), it can be opened as an output channel. Of 
course, the characteristics of the device will determine if it is valid to 
do so. This subroutine must be executed before subroutine $FFD2 
(output character to channel) is executed for a device other than the 
CRT. If output to the CRT is desired, and there is no association to an 
open file by logical file number, then the call to this subroutine may be 
dispensed with. On the IEEE this subroutine results in sending a listen 
address followed by a secondan/ address if one was specified in the 
open subroutine ($FFCO). 

$FFCC — Close Input and Output Channels. 

Communicating registers: none. 
Error Returns: none 
Stack Requirements: 
Preparaton/ routines: none. 

Decription: After opening a channel and performing 1/0, this 
routine closes all open channels and restores the default channels. 
Default input is device (keyboard) and output device 3 (CRT screen). 
This routine may be called optionally by the programmer. An 'untalk' 
is sent to clear the input channel if the device is on the lEE. An 
'unlisten' is sent to clear the output channel. By not calling this 
routine and leaving a listener addressed on the IEEE, multiple devices 
can receive data on the bus. An example would be to address the 
printer to listen and the disk to talk. 
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$FFCF — Input Character from Channel. 

Connnnunicating registers: processor accunnulator. 
Error Returns: see routine $FFB7. 
Stack Requirennents: 
Preparatop/ routines: none. 

Description: A call to this routine will return a character of data fronn 
the channel set up by a call to subroutine $FFC6 (open channel for 
input), or the default input channel if no other has been set up. Data is 
returned in the accunnulator. The channel rennains open after the call. 
In the case of the keyboard device, the cursor is turned on and 
continues to blink until carriage return is typed. Characters on the line 
are then returned one by one, by calls to this routine. Finally carriage 
return is sent and the process begins again. 

$FFD2 — Output Character to Channel. 

Con^municating registers: processor accunnulator. 
Error Returns: see routine $FFB7. 
Stack Requirennents: 
Preparatop/ routines: none. 

Description: The data to be output is loaded into the accunnulator. A 
call to $FFC9 (open channel for output) sets up the output channel, or 
if this call is onnitted, data is sent to the default device which is 
nunnber 3, the CRT. The character can be transnnitted to nnultiple 
devices on the IEEE if a clear channel is not perfornned after the 
corresponding open channel for output. 

$FFD5 — Load RAM fronn Device. 

Connnnunicating registers: processor accunnulator, X and Y index 

registers. 

Error Returns: 0, 4, 5, 8 and 9. 

Stack requirennents: 

Preparatop/ routines: $FFBA and $FFBD. 

Description: Load fronn device into RAM. On call accunnulator = 
for load, or accunnulator = 1 for verify. The index registers (X, Y) 
contain the address to load into for secondap/ address = 3. If the 
secondap/ address = 0, 1 or 2 then the block will load into memory 
starting at the address specified in the block header. On return the 
highest RAM address loaded is contained in the index registers (X, Y). 
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$FFD8 — Save RAM to Device. 

Communicating registers: X and Y index registers. 

Error Returns: 5, 8 and 9 

Stack Requirements: 

Preparaton/ routines: $FFBA, $FFBD and FF9C. 

Description: Saves memory from the bottom of memon/ (set by 
routine $FF9C) to the memon/ address (X, Y) to a logical device. A file 
name is not required for device 1 (the cassette deck) but an error 
condition exists for any other device saved without a file name. Device 
(keyboard), and device 3 (screen) are not defined for this routine. 



$FFDB — Set Real Time Clock. 

Communicating registers: processor accumulator, X and Y index 

registers. 

Error Returns: none. 

Stack Requirements: 

Preparaton/ routines: none. 

Description: A system clock is maintained on a 1/60 second 
interrupt basis. Three bytes are provided to count jiffies up to 
5,184,000 or 24 hours, at which point the clock rolls over to zero. To set 
the clock load the accumulator with the most significant, X index with 
the next most significant and Y index with least significant byte of 
time in jiffies. 



$FFDE — Read Real Time Clock. 

Communicating registers: processor accumulator, X and Y index 

registers. 

Error Returns: none. 

Stack Requirements: 2. 

Preparaton/ routines: none. 

Description: The system clock can be read at any time. Three bytes 
are returned containing a binan/ value corresponding to the time in 
1/60 of a second. The accumulator contains the most significant, X 
index next most significant, and Y index the least significant byte. 
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$FFE1— Check Stop Key. 

Communicating registers: processor accumulator. 
Error returns: none. 
Stack Requirements. 
Preparatory routines: none. 

Description: This routine sets the Z flag if the STOP key on the 
keyboard is pressed while the routine is called. All other flags are 
maintained. If the stop key is not pressed then the accumulator 
contains a byte corresponding to the last row of the keyboard scan. 
The user can check for other key closures in this manner. 

$FFE4 — Get Character from Keyboard Queue. 

Communicating registers: processor accumulator. 
Error Returns: none. 
Stack Requirements: 
Preparaton/ routines: none. 

Descnption: Get buffered character from keyboard queue. This 
subroutine removes one character from the keyboard queue and 
returns an ASCII value in the accumulator. If the queue is empty, the 
value returned will be zero. Characters are put into the queue by an 
interrupt driver scan which calls the routine $FF9F. Obviously these 
routines will not work if the interrupt is disabled in any way. 

$FFE7 — Close All Files. 

Communicating registers: none. 
Error returns: none. 
Stack Requirements: 1 1 . 
Preparaton/ routines: none. 

Description: With this subroutine the pointers into the open file 
table are reset. Additionally, the routine $FFCC (close input and 
output channel) is called to reset the I/O channels. 

$FFEA — Increment Real Time Clock. 

Communicating registers: none. 
Error Returns: none. 
Stack Requirements: 2. 
Preparaton/ routines: none. 

Description: Normally this routine is called even/ l/60th second to 
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keep the system clock register updated. If the user processes own 
interrupts then this subroutine nnust be regularly called to update 
tinne and keep the STOP key routine functional. 

$FFED — Return X, Y Organisation of Screen. 

Connnnunicating registers: X and Y index registers. 

Error Returns: 

Stack Requirennents: 2 

Preparaton/ routines: none. 

Description: Returns the constant organisation of the screen e.g. 22 
colunnns in .X and 23 lines in .Y. This routine has two nnain uses, it 
allows software to be written for the VIC 20 to be run on a future VIC 
40 without any change in screen handling routines, the progrann will 
recognise which nnachine it is being run on. Secondly the 6561 allows 
the user to change the screen organisation, within certain linnits, this 
routine can be used to check current organisation. 

$FFFO — Read/Set X, Y Cursor Position. 

Connnnunicating registers: X and Y index registers. 
Error Returns: none. 
Stack Requirennents: 2. 
Preparaton/ routines: none. 

Description: A call with earn/ set reads the current X, Y position of 
the cursor on the screen into .X and .Y. A call with earn/ clear nnoves 
the cursor to location X, Y on the screen as deternnined by the 
contents of .Xand .Y. 

$FFF3 — Return Base Address of I/O. 

Connnnunicating registers: X and Y index registers. 
Error Returns: none. 
Stack Requirennents: 2. 
Preparaton/ routines: none. 

Description: Returns the address of the page containing I/O in X, Y. 
This routine can be used with an offset to access nnennon/ nnapped I/O 
devices in the VIC. This function and subsequent register accesses are 
nnachine dependent. 
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SYSTEM INITIALISATION AND AUTO POWER UP 

When the VIC is switched on, a pre-defined initialisation sequence 
is executed. This initialisation sets the system up so that all RAM 
variables and vectors are correctly set; screen I/O and keyboard 
correctly defined; nnennon/ checked and the Basic interpreter set in 
the direct input nnode. This initialisation sequence is triggered by the 
power on reset circuit. The reset circuitn/ on the VIC consists of a 555 
tinner 10 wired in such a way that when power is first switched on the 
reset line is held low for a short period. When the processor reset line 
is pulled low nnonnentarily (nnininnunn six clock cycles) it causes the 
processor to start execution of a progrann whose starting address is 
stored in locations $FFFC and $FFFD. The start routine whose address 
is contained in the reset sector is located at $FD22. 

The start routine is typical of the great flexability inherant in the 
design of the VIC. It allows two options, go-to the initialisation routine 
contained in ROM expansion mennon/. The nornnal initialisation 
routine (located at $FD2F) is used whenever the VIC is to run 
programs in Basic or Basic progranns with nnachine code subroutines. 
The initialisation code sets up the OS RAM vectors, the I/O devices, 
initialises the 6561 and then junnps to the start of Basic at location 
$0000. 

The area of nnennon/ allocated for nnennon/ expansion on the VIC can 
be divided into three sections. Mennon/ space reserved exclusively for 
ROM nnennon/, space reserved for either ROM or RAM nnennon/, and 
that reserved exclusively for RAM nnennon/ expansion. The section of 
expansion nnennon/ that is of interest in its connection with systenn 
initialisation is that reserved exclusively for ROM nnennon/, locations 
$A000 to $BFFF. The first function of the start routine at $FD22 is to 
check if there is a ROM inserted in address space $A000. It does this by 
testing for a string of 5 characters starting at a specific location on the 
ROM. The sequence of five bytes searched for is: 



Address - 


- $A004 


contents - 


-$41 


ASCII character— 'A' 




$A005 




$30 


■0' 




$A006 




$C3 


rvs'C 




$A007 




$C2 


rvs'B' 




$A008 




$CD 


rvs 'M' 



If the start routine finds this character string then progrann control 
junnps to an address stored in the first two bytes of the ROM, $A000 
and $A001, the user written 'hard start' initialisation routine. A 
second jump address is stored in locations $A002 and $A003, this is 
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the 'warm start' routine which returns progrann control to Basic, it is 
called when the Restore key is pressed. If the 'AOCBM' character 
string is not found then the zero flag is set and the initialisation 
routine at $FD2F called. 

This feature of the VIC will allow the nnachine to be used in a wide 
range of special applications where the progrannnrier requires the 
nnachine to autonnatically power up into his progrann. All the 
connnnercial ROM based gannes packs use this nnethod. The nnost 
interesting application is the enhancennent or alteration of Basic by 
adding extra comnnands or changing the operation of existing 
connnnands. The exannple shown in Appendix 2 dennonstrates how 
extra connmands can be added, the exannple adds a range of graphic 
connnnands to Basic. This progrann can easily be nnodified to run any 
connnnands required by the user, sinnply by adding the connnnand 
nanne and the start address of its associated subroutine into the 
connnnand tables starting at $A056. Existing connnnands involving 
systenn I/O can be nnodified if those connnnands use one or nnore of the 
RAM vector addresses. This is done by sinnply changing the RAM 
vector address so that it points to a routine in the $A000 ROM, this 
routine then perfornns the new version of that routine. An exannple 
would be if the progrannnner required the VIC to connnnunicate with 
devices using a different connnnunications systenn, e.g. Centronics, to 
that provided on the VIC (senal IEEE, or RS-232). In this case all the I/O 
routines in the kernal would have to be changed so that data was 
input and output in the right fornnat. The new versions of the I/O 
routines are put in the $A000 ROM and the initialisation routine 
sinnply sets up the correct new RAM vector addresses before 
returning to the nnain initialisation routine and Basic. 
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SYSTEM WEDGES 

A system wedge is a machine code routine inserted into the normal 
system software, allowing the user to either modify the system 
operation or monitor system functioning. There are two main 
positions where code can be wedged into the VIC system software, 
they are: 

Interrupt wedge — code inserted into one or other of the two 
interrupt handling routines (NMI or IRQ) using the interrupt RAM 
vector jump addresses. A wedge routine inserted into the regular 
60Hz IRQ interrupt can be used to scan for l/Q input or perform 
background processing. 

RAM vector wedge — a wedge routine inserted into one or more of 
the RAM vectors could be used to change the I/O configuration or file 
handling capabilities of the system. 

CHARGOT wedge — this is a wedge inserted into the CHARGOT 
subroutine in page zero memon/. Such a wedge can be used to 
intercept each Basic command in a program as it is executed. The 
principle use for such a wedge is to add extra commands to the Basic 
interpreter. 

Three routines are required to implement a system wedge; 

1 — the wedge must be initialised, this is done by a routine 
inserting a jump address to the wedge code into the CHARGQT 
routine or replacing an existing RAM vector address. 

2 — the wedge code, this code performs the required function 
which amends or replaces the system function into which it is 
inserted. If an interrupt wedge is used, the wedge code should be 
terminated with a jump to the address originals contained in the 
interrupt vector. With a RAM vector wedge the wedge code can be 
terminated with either a jump to the normal function subroutine, or 
simply terminated with an RTS instruction, depending on the 
programmers requirements. A CHARGOT wedge is terminated with 
the section of the CHARGOT code which is replaced by the wedge 
jump address followed by an RTS instruction. 

3 — when the wedge code is finished with it must be disabled by 
returning the vector addresses to normal or restoring the normal 
CHARGOT routine. The following system subroutines can be utilised 
to do this operation: 
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$E45B — restore vectors 
$E3A4 — restore CHARCOT and zero page 
Examples of these routines are shown in the following progranns. 



0073 


;NorTrjaI 


CHflRGuT cc 


de 




0073 










0073 


E6 7h 


CHhRGOT 


INC 


$00 ?H 


0075 


Dh i^-i2 




ENE 


CHRRGOT 1 


0077 


E6 7E 




INC 


:f00?B 


0079 


HC ** ** 


CHflRGCfTl 


LDR 


POINTER 


007C 


C9 3n 




CMF 


#$3fi 


007E 


B0 0fl 




W.f 


CHHRG0T2 


0080 


r;9 2^"^ 




CMF 


#$20 


0032 


F0 EF 




BEG 


CHFiRGOT 


0084 


■"!= C' 




SEC 




0085 


Eli 30 




SEC 


#*30 


0087 


• J i~j 




SEC 




0088 


E3 ne 




SEC 


#$D0 


008H 


60 


CHHRGUT2 


RTS 




0073 


.' User i.ued'if'E' In "to C 


HhRGOT c^ode 


0073 










0073 


Eb ?H 


WEDGE 


INC 


■$Q07fi 


0075 


D0 02 




ENE 


NEDGEl 


0077 


E6 ?E 




INC 


*00?E 


0079 


Hii ** *•*• 


WEDGE 1 


LDh 


POINTER 


00 7 C 


09 3h 




CMF 


#*3H 


007E 


F0 8h 




EEC 


WEDGE2 


0080 


C9 20 




CMF 


#$20 


0082 


F0 EF 




EEG 


WEDGE 


0084 


20 00 10 




JSR 


CODE 


0087 


20 00 18 




JSR 


replhce 


008H 


tS 


WEDGE2 


RTS 




1000 


.; start ,: 


jf USE't"' UJ'E'Ch 


■se r-'r 


O'ifraxii 


1800 


; Rep Is.cernent tor C 


HhRGC 


1 'jLHjf i'C' 



,^~ 
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LOC 



CODE 



LINE 



E378 


20 


5B 


E4 


E37D 


20 


A4 


E3 


E37E 


20 


04 


E4 


E381 


A2 


FB 




E383 


9A 






E384 


4C 


74 


C4 



INIT JSR INITV ;G0 INIT VECTORS 

JSR INirCZ .GO INIT CHARGET Ic Z-PAGE 

JSR INITM5 ; GO PRINT INIT MESSAGF, 

LDX *»5TK£ND-256 i SET UP END OF STACK 

IXS 

JMP READY ; GO TO READY 



E387 


E6 


7A 


INITAT 


INC 


CHRGET+7 


E3n9 


DO 


02 




ONE 


CHDGOT 


E38D 


E6 


7B 




INC 


CHRGET+8 


E38D 


AD 


60 EA 


CHDGOT 


LDA 


60000 


E390 


C9 


3A 




CMP 


#': 


E392 


BO 


OA 




BCS 


CHDRTS 


E394 


C9 


20 




CMP 


#' 


E396 


FO 


EF 




BEQ 


INITAT 


E398 


38 






BEC 




E399 


E9 


30 




SBC 


#'0 


E39B 


38 






SEC 




E39C 


E9 


DO 




SBC 


#*D0 


E39E 


60 




CHDRTS 


RTS 




E39F 


80 






BYT 128. 79, 


E3A0 


4F 










E3A1 


C7 










E3A2 


52 










E3A3 


58 











E3A4 


A9 


4C 


INITCZ LDA 


#76 




E3A6 


85 


54 


5TA 


JMPER 




E3AB 


85 


00 


5TA 


USRPOK 




E3AA 


A9 


48 


LDA 


# CFCLRR 




E3AC 


AO 


D2 


LDY 


*L FCLRR 




E3AE 


85 


01 


GTA 


USRPOK+1 




E3B0 


84 


02 


niY 


U5RPGK+2 




E3B2 


A9 


91 


LDA 


tt GIVAYF 




E3B4 


AO 


D3 


LDV 


#: GIVAYF 




E3B6 


85 


05 


STA 


ADRAY2 




E3B8 


84 


06 


STY 


ADRAY2+1 




E3BA 


A9 


AA 


LDA 


# IFLPINT 




E3BC 


AO 


Dl 


LDY 


#:flpint 




E3BE 


85 


03 


SIA 


ADRAYl 




E3C0 


84 


04 


STY 


ADRAYl -^1 




E3C2 


A2 


IC 


LDX 


♦tlNITCZ-INITAT- 


-1 


E3C4 


BD 


87 E3 


MOVCHQ LDA 


INITAT, X 




E3C7 


75 


73 


P) PA 


CHRGET, X 




L3C9 


CA 




]}r.y 
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LOG 



CODE 



LINE 



E3CA 


10 


FB 






DPL 


MOVCHG 


E3CC 


A9 


03 






LDA 


#STRSIZ 


E3CE 


85 


53 






STA 


F0UR6 


E3D0 


A9 


00 






LDA 


^0 


E3D2 


8C> 


68 






STA 


BITS 


E3D4 


85 


13 






STA 


CHANNL 


E3D6 


85 


18 






STA 


LASrPT-H 


E3D3 


A3 


01 






LDX 


#1 


E3DA 


8E 


FD 


01 




STX 


BUF-3 


E3DD 


8E 


FC 


01 




BTX 


BUF~4 


E3E0 


A2 


19 






LDX 


#TEMPST 


E3E2 


86 


16 






STX 


TEMPPT 


E3E4 


38 








SEC 




E3E5 


20 


9C 


FF 




vJSR 


*FF9C 


E3E8 


86 


213 






STX 


TXTTAB 


E3EA 


84 


2C 






STY 


TXTTAB-H 


E3EC 


38 








SEC 




E3ED 


20 


99 


FF 




JSR 


*FF99 


E3F0 


86 


37 




USEDEF 


STX 


MEMS I Z 


E3F2 


84 


33 






STY 


MEMSIZ-H 


E3F4 


86 


33 






BTX 


FRETOP 


E3F6 


84 


34 






STY 


FRETOP-H 


E3F8 


AO 


00 






LDY 


#0 


E3FA 


98 








TYA 




E3FD 


91 


2S 






STA 


(TXTTAB)Y 


E3FD 


E6 


2B 






INC 


TXTTAB 


E3FF 


DO 


02 






ONE 


INIT20 


E401 


E6 


2C 






INC 


TXTTAB-^1 


E403 


60 






INIT20 


RTS 





I READ BOTTOM OF MEMORY 
;NOW TXTAD HAS IT 

i READ TOP OF MEMORY 



E404 


A5 


2D 




INITMS LDA 


TXTTAB 


E406 


A4 


2C 




LDY 


TXTTAB-»"1 


E40a 


20 


08 


C4 


JSR 


REASON 


E400 


A9 


36 




LDA 


tt :fremes 


E40D 


AO 


L"4 




LDY 


^; Ff?EMES 


E40F 


20 


IE 


CD 


JSR 


STROUT 


E^12 


A5 


37 




1. DA 


ML" MS I Z 


E414 


33 






SEC 




r4 1 b 


E5 


2B 




SOC 


TXTTAB 


E417 


AA 






TAX 




E4ie 


A5 


3B 




LDA 


MEMSI Z+1 


E41 A 


E5 


2C 




srjc 


TXTTAB+l 


E4 1C 


20 


CD 


DD 


JSR 


LINPRT 


E41F 


A9 


r79 




LDA 


U MQi^OS 


E421 


AO 


E4 




LDY 


tt>WORDS 


E423 


20 


IE 


CB 


JSR 


STROUT 


E426 


4C 


44 


C6 


JMP 


SCRTCH 
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LOG 



CODE 



LINE 



E^29 


20 


42 


E434 


OD 




E435 


00 




E436 


93 




E437 


2A 


2A 


E44D 


OD 




E44E 


00 





WORDS . [^YT ' BYTF5 FREES 13,0 

FREMES .BYT 147, '♦♦♦# CDM BASIC V2 ♦♦♦♦ ' 
. BYT 13, O 



E44F 


3A 


C4 




DVTRS 


. WOR NERROR, NMAIN, 1 


E451 


83 


C4 








E453 


7C 


C5 








E455 


lA 


C7 








E457 


E4 


C7 








E459 


86 


CE 








E45D 








; 




E45B 


A2 


OB 




INITV 


LDX *HNITV-BVTRS-1 


E45D 


BD 


4F 


E4 


INITVl 


LDA BVTRS, X 


E460 


9D 


00 


03 




STA lERROR. X 


E463 


CA 








DEX 


E464 


10 


F7 






DPL INITVl 


E466 


60 








RTS 



NGONEi NEVAL 



INIT VECTORS 
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OVERVIEW OF THE 6561 VIDEO INTERFACE CHIP 

Many of the VIC's outstanding features are attributable to a single 
integrated circuit, the 6561 video interface chip. This single device 
provides all the circuitn/ necessan/ to generate colour programmable 
character graphics, with high screen resolution. The 6561 also 
incorporates sound effects generation, analogue to digital conversion 
for joysticks, and light pen capability. All these functions are under 
direct programmer control via the 16 addressable control registers of 
the 6561, to use these functions an understanding of the 6561 's 
operation is essential. The video interface chip has three seperate 
functions, these are: 

1 — Control and generation of the CRT display. 

2 — Generation of the master oscillator clock. 

3 — Specialised I/O for use in the video-games environment. 

Only functions 1 and 3 are of interest to the programmer, the 
generation of the master oscillator clock is purely a hardware feature 
which ensures that all the system timing is synchronised with that of 
the 6561. 

The control and generation of a colour display on a TV or monitor is 
the priman/ function of the 6561. To do this it must access four 
seperate areas of the VIC's memon/ space, the location and size of 
two of these areas is under programmer control. The four memon/ 
areas each have their own function in display generation, they are: 

1 — Video RAM character pointer, each location corresponds to a 
position on the screen, location in this section of RAM contains the 
ASCII code of the character displayed in the top left corner of the 
screen, location 1 has the next character to the right and so on for all 
the character positions on the screen. On the standard VIC with no 
memon/ expansion, this section of memon/ is 506 bytes long starting 
at location $1E00, if there is more than the bottom 3K memon/ 
expansion then the starting location is $1 000. 

2 — Colour pointer, this section of RAM is identical in size to the 
video character pointer and contains data on the foreground and 
background colour of each character. Location in this section 
contains the foreground and background colour of the character in 
location of the character pointer (i.e. top left character on the 
screen), and so on for all character positions on the screen. On the 
standard VIC with no memon/ expansion this section of memon/ is 
506 bytes long starting at location $9600, if there is more than 3K of 
expansion memon/ then the starting address is $9800. 
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3 — Character generator, this section of nnennon/ contains the 
pattern of dots used to display each of the 255 different characters, 
the dot pattern for each character is contained in eight consecutive 
nnennon/ locations (this can be set to 16 consecutive locations if 
required), each bit of each byte corresponding to a dot position in that 
character, 1 = a dot and = a space. The character generator in 
nornnal operation is stored in a 4K ROM, starting address $8000. By 
re-defining the character generator start address to point to 4K block 
of RAM a user definable character generator can be created. 

4 — 6561 control registers, these registers control the way in 
which the 6561 operates and are located in 16 consecutive nnennon/ 
locations (their address is defined by hardware). The addresses used 
lie between $9000 and $900F. 

In nornnal operation the kernal initialisation routines set up the 
registers of the 6561 to give the standard VIC display fornnat, 23 lines 
by 22 colunnns, using the character generator at location $8000. The 
routines then put space characters into all locations in the character 
pointer RAM and set all locations in the colour pointer to give blue on 
white characters, control register 16 is set to give a white background 
and a cyan border. 

To understand the operation of the VIC nnore connpletely, consider 
the diagram in Figure 8. This shows the three areas of memon/ used, 
video RAM, colour RAM, and character generator for a standard 22 
coiunnn, 23 line display. Each of the 506 locations in the video RAM 
contains a code value or pointer into the character generator, in the 
diagrann the location corresponding to coiunnn 22, line 10 contains the 
value 45. This nneans that character nunnber 45 is displayed in that 
character space, the same location in the colour RAM contains the 
value 2, this makes the character red. Teh character number is used as 
an index into the character generator. The VIC fetches each of the 506 
video RAM location values and performs an address computation on 
each of them to locate the desired value of the address of the eight 
bytes used to store each character in the character generator. The 
address computation is quite simple, if 8x8 characters are being used 
then the character code value (45 in the examiple) is multiplied by 
eight and the result added to the start address of the character 
generator (this base address is contained in the 6561 control register 
No. 5.). The eight bytes of the character generator pointed to by this 
address, are transfered (one byte per scan line) via an internal shift 
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register on the 6561 to the video display as a serial bit stream. This bit 
stream combined with control pulses from the 6561 comprises the 
composite video output signal of the VIC. This signal is fed via a 
modulator to the TV set which then generates the required display. 

Besides controlling the video output of the VIC the 6561 
implements a series of interactive I/O features which are designed 
principaly for games applications. There are three of these features, 
they are; 

1 — Sound generation system consisting of: three independently 
programmable tone generators, a white noise generator, and an 
amplitude modulator. The sound generation system can be used to 
create special sound effects and can even be used to play music of 
acceptable quality. 

2 — Two anaologue to digital converters, these are intended for use 
with a potentiometer or joystick input, ideal for moving the cursor or 
games character about the screen. 

3 — Light pen input, a photocell connected to this input and 
pointed to a part of the screen will return the screen co-ordinates of 
that point in two of the 6561 internal registers, ideal for interactive 
non keyboard input. 
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THE INTERNAL REGISTERS OF THE 6561 

The sixteen eight bit control registers within the 6561 enable the 
nnicroprocessor to control all the operating nnodes of the VIC. These 
control registers connprise sixteen successive nnennory locations 
starting at location 36864, and are accessible from either Basic (using 
PEEK and POKE) or nnachine code progranns. The sixteen control 
registers of the 6561 areas follows: 

Control register No. 1. 

Location — Hex $9000 Decimal 35864 

Contents in normal VIC operating mode — Decimal 1 2 

Bits to 6 of this register determine how far from the left side of the 
TV screen the first column of characters will appear. It is used to 
horizontally centre various sizes of video matrices on screen. Bit 7 
when set to 1 enables the interlaced scan mode. Interlacing can be 
used with the appropriate hardware to display the VIC screen over a 
normal TV picture, this could be used for video titleing. 

To demonstrate the horizontal movement of the screen by changing 
the contents of this register enter and run the following program: 

10FORQ=0TO40 

20 POKE 36864,0 

30FORX=0TO1000:NEXTX :delay 

40NEXTO 

50 POKE 36864, 12 : restore to normal 

To demonstrate the effect of an interlaced display enter this 
command: 

POKE 36864,140 

Control register No. 2. 

Location — Hex $9001 Decimal 36865 

Contents in normal VIC operating mode — Decimal 38 

Determines how far from the top of the TV screen the first row of 
characters will appear. It is used to vertically centre various sizes of 
video matnx on the screen. 

To demonstrate the vertical movement of the screen by changing the 
contents of this register enter and run the following program : 

10FORO=0TOl50 

20 POKE 36865,0 

30FORX=0TO100:NEXTX :delay 
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40 NEXT Q 

50 POKE 36865,38 .restore to normal 

Control register No. 3. 

Location — Hex $9002 Decinnal 36866 

Contents in nornnal VIC operating nnode — Decinnal 1 50 

Bits 0-6 deternnine the nunnber of colunnns in the video nnatrix, thus for 
a 22 coiunnn screen bits 0-6 will contain the value 22. Bit 7 is part of the 
video nnatrix address stored in control register No. 6, this bit is 
nornnally set to logical '^' (i.e. add decimal 128 to value in bits 0-6). 

To demonstrate the use of this register to change the number of 
columns displayed on the screen enter and run the following 
program: 

10FORQ=128TO155 

20 POKE 36866,0 

30FORX=0TO1000:NEXTX .delay 

40 NEXT O 

50 POKE 36866, 1 50 : restore to normal 

Control register No. 4. 

Location — Hex $9003 Decimal 36867 

Contents in normal VIC operating mode — Decimal 1 74 

Bits 1 to 6 set the number of rows in the video matrix. Bit is used to 
select either 8x8 characters (bit = 0) or 16x8 character matrices (bit 
= 1). Bit 7 is the least significant bit of the raster line number found in 
control register No. 5. 

To demonstrate the use of this register to change the number of lines 
displayed on the screen enter and run the following program: 

10FORO=128TO180STEP2 

20POKE36867,Q 

30FORX=0TO1000:NEXTX :delay 

40 NEXT O 

50 POKE 36867, 1 74 : restore to normal 

Control register No. 5. 

Location — Hex $9004 Decimal 36868 

Contents in normal VIC operating mode — Variable 

This register contains the number of the line currently being scanned 
by the TV raster beam. 
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Control register No. 6. 

Location — Hex $9005 Decimal 36869 

Contents in normal VIC operating mode — Decimal 240 

Bits to 3 determine the starting address of the character cell space 
(note that these bits form lines A13 to A10 of the actual address). Bits 
4 to 7 together with bit 7 of control register No. 3., determine the 
starting address of the video matrix (these bits form address lines A13 
to A9 of the actual address). 

Control register No. 7. 

Location — Hex $9006 Decimal 36870 

Contents in normal VIC operating mode — Decimal 

Contains the latched horizontal position of the light pen 



Control register No. 8. 

Location — Hex $9007 Decimal 36871 

Contents in normal VIC operating mode — Decimal 

Contains the latched vertical position of the light pen 



Control register No. 9. 

Location — Hex $9008 Decimal 36872 

Contents in normal VIC operating mode - Decimal 255 

Contains the digitised value of input on potentiometer No. 1., (see 
section on joysticks for details on operation and use). 

Control register No. 10. 

Location — Hex $9009 Decimal 36873 

Contents in normal VIC operating mode — Decimal 255 

Contains the digitised value of input on potentiometer No. 2., (see 
section on joysticks for details on operation and use). 

Control register No. 11. 

Location — Hex $900A Decimal 36874 

Contents in normal VIC operating mode — Decimal 
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Bits to 6 set the frequency of the first audio oscillator. 
Bit 7 turns the oscillator on ( = 1 ) or off (=0). 

Control register No. 12. 

Location — Hex $9008 Decinnal 36875 

Contents in nornnal VIC operating nnode — Decinnal 

Bits to 6 set the frequency of the second audio oscillator. Bit 7 turns 
the oscillator on (=1) or off (= 0). 

Control register No. 13. 

Location — Hex $900C Decinnal 36876 

Contents in nornnal VIC operating nnode — Decimal 

Bits to 6 set the frequency of the third audio oscillator. Bit 7 turns the 
oscillator on (= 1 ) or off (=0). 

Control register No. 14. 

Location — Hex $900D Decinnal 36877 

Contents in nornnal VIC operating nnode — Decimal 

Bits to 6 set the base frequency for the pseudo white noise 
generator. Bit 7 turns the noise generator on (= 1 ) or off (=0). 

Control register No. 15. 

Location — Hex $900E Decimal 36878 

Contents in normal VIC operating mode — Decimal 

Bits to 3 set the volume of the composite audio signal (note that at 
least one sound generator must be turned on for any sound to be 
produced). Bits 4 to 7 contain the auxilian/ colour code used in 
conjunction with the 'Multicolour mode' of operation. 

Control register No. 16. 

Location — Hex $900F Decimal 36879 

Contents in normal VIC operating mode — Decimal 27 

Bits 4 to 7 select one of sixteen colours for the background common to 
all characters on the screen (essentially they set the colour of the 
background area within the video matrix). Bits to 2 select one of 
eight colours for the exterior border area of the screen, this is the area 
outside the video matrix. Bit 3 determines whether the video matrix is 
to be displayed as different coloured characters on a common 
background colour (bit 3 = 1), or inverted (bit 3=0) where all 
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characters have the same colour, but different background colours 
deternnined by the code in the colour RAM. Bit 3 has no effect when 
the 'Multicolour' nnode is selected on the 6561, the other functions of 
control register No. 1 6., also van/ in this nnode. 

To dennonstrate the changing of the border colour (there are eight 
different colours) by bits 0-2, run the following progrann. Note that the 
screen colours are retained in their nornnal nnode of blue characters on 
a white background. 

10FORQ=0TO7 

20 PIKE36879,Q+24 xhange border colour 

30 FORX-1TO1000:NEXTX :delay 

40NEXTQ 

50GOTO10 

The sixteen different background colours are selected by bits 4-7 and 
the following progrann dennonstrates the changing of the background 
colour, note the cyan border colour and the blue character colour 
rennain unchanged. 

10FORQ=0TO255STEP16 

20 POKE36879,Q-h1 1 :new background colour 

30FORX=1TO1000:NEXTX 

40NEXTQ 

50GOT10 

Bit 3 controls whether characters are displayed on a connnnon 
background colour, or inverted so that all characters are the sanne 
colour but the background is a different colour. The following short 
progrann dennonstrates this. 

10POKE36879,PEEK(36879)AND247 : invert background 

20 FORQ=-TO1000:NEXTQ :delay 

30 POKE36879,PEEK(36879)OR8 :restore to nornnal 

40 FORQ=0TO1000:NEXTQ 

50GOTO10 
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6561 DISPLAY MODES 

The VIC has two display modes, normal text mode and user 
definable character mode. The modes are determined by the position 
in memory of the character generator. There are also two modes of 
colour operation, high resolution, and multicolour. The VIC is thus 
capable of several permutations of colour and display mode. 

The two display modes depend on whether the normal internal 
ROM based character generator is used or a user definable RAM 
character generator. The position of the character generator within 
processor memor/ space is determined by the contents of bits 0-3 of 
control register No. 5. These four bits form bits A10 to A13 of the actual 
character generator address as follows: 



3 


2 




1 






11 Olxx xxxx xxxx 

$ 3 4 

The normal contents of bits 0-3 of control register No. 5., are zero, the 
way the VIC is configured, this gives a character generator address of 
Hex $8000 (decimal 32768). Starting at this location is a 4K ROM, the 
character generator. This contains the actual dot pattern for each of 
the 256 different characters which can be displayed. The 4K character 
generator ROM actualy contains two seperate character generators 
each occupying 2K of ROM. The first of these two character 
generators which starts at address Hex $8000 (decimal 327680 
contains the dot pattern for the 128 normal upper case and graphics 
characters plus the 128 reverse field versions of the same characters. 
The second character generator starts at location $8800 (decimal 
34816) and is identical to the first except that part of the graphics 
character set is replaced by lower case characters. When the second 
character set is enabled the VIC will normally display in lower case 
characters rather than the normal upper case, upper case will be 
displayed with the shift key depressed. The second character 
generator can be enabled normally, by pressing the shift key and the 
Commodore logo key simultaneously. Alternatively one can change 
the contents of control register No. 5., thus: 

POKE 36869,242 : set lower case display mode 

POKE 36869,240 :set upper case display mode 

This simply shifts the starting address of the character generator up 
2K in memory thereby accessing the second character generator. 



120 



The character generator starting address in control register No. 5. 
can be changed so that the character generator is located in RAM, 
thereby allowing user definable characters to be created. The starting 
address of the user definable RAM character generator on the VIC can 
be any 2K (4K if 8x16 characters are used) block or RAM, located 
between address Hex $1000 and $3000. It should be located at the 
highest possible address, and protected fronn being overwritten by 
Basic by lowenng the top of nnennon/ pointers, to protect the RAM 
space used by the character generator. The setting up of control 
register No. 5., has the following rules: 

1 — The starting address is always located at the beginning of a IK 
block. 

2 — If the contents of bits 2 and 3 are both zero then the starting 
address defaults to the ROM at $8000 plus the offset stored in bits 
and 1 , this offset is in incrennents of 1 K. 

3 — Bits 2 and 3 contain the starting address in incrennents of 4K. 

Thus to put the user definable character generator to start at 1 1 K up 
in nnennon/, — Hex $2000 — 2x 4K block plus 3x 1 K block — then bits 
to 3 would be set up as follows: 

Bits 3 2 10 

Binan/ contents 10 11 

representing 2x4K blocks 3x 1 K blocks 

The user definable character generator is ven/ innportant, since it 
not only allows special graphics characters to be created, but it also 
allows high resolution point plotting on the VIC. This allows a graph 
or display to be created with a resolution of 176 points in the 
horizontal by 184 points vertically, sufficient to give a ven/ good 
quality display. High resolution point plotting is achieved by 
progrannnning techniques using the user definable character 
generator. The use of the RAM character generator nnust be 
understood before these techniques can be explained. 

The first stage in creating a user definable character set, is to 
allocate a block of RAM nnennon/ for storage of the character 
generator. If characters on an 8x8 nnatrix are being displayed then 
2048 nnennon/ locations are required, if an 8x16 nnatrix is to be used 
then 4096 locations are required. Since a standard VIC has only 3584 
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RAM memory locations available to the user, an 8x8 matrix user 
definable character generator using 2048 of these locations is the only 
one feasible. The user RAM on a standard unexpanded VIC starts at 
memon/ address 4096 and goes on to address 7679. The character 
generator can be programmed to start at any of the following 
addresses within that range; 4096, 5120, 6144, or 7168. Since 2048 
locations are required for the character generator the only possible 
starting location is 5120, this leaves 1024 bytes free for user programs 
(not much, purchase of the standard 3K RAM expansion module is 
strongly recommended, it's use will not change the start address 
recommended above). This area of RAM chosen for use by the 
character generator must be protected from being overwritten by a 
Basic program or data. If this happened the display would be 
destroyed. The user definable character generator can be protected 
from being overwritten by lowering the top of memory pointers, 
thus: 

10 POKE 51,255 : POKE 52,19 

11 POKE 55,255': POKE 56,19 
12CLR 

The next stage is to put the data on each character into the new 
character generator, by using POKE commands or machine code load 
statements to put information into the 2048 memon/ locations. 
Before this can be done each of the new characters must be designed, 
this entails drawing each character on an 8x8 grid, see Fig. 15. Once the 
character has been designed it can be converted into the block of 
eight numerical values for storage in the character generator. Each 
line in the 8x8 gnd corresponds to a byte of data, and each of the eight 
bits in that byte corresponds to a dot or column position on that line. 
Information is stored in memory in binary, thus by considering each 
bright dot to be a logical '1' and each space a logical '0', a line of dots in 
each character can be converted into a numerical value, the way this is 
done is shown in Fig. 14. Some examples of character designs and their 
conversion to numerical values are shown in Fig. 16. From these values 
a table can be created, one column having the character generator 
address, and the corresponding entn/ in the second column having 
the value to be put into that location. The table is divided into blocks 
of eight entries, each block containing the data for one character. Each 
of these blocks of eight entries is numbered starting at and going up 
to 255. These numbers correspond to the ASCII or character code 
numbers stored in the video RAM when the characters are displayed. 
An example table using the character designs in Fig. 15 is shown in Fig. 
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Fig. 16 — Conversion of user characters into a character generator table. 
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16. The table need only contain the nunnber of characters actually 
required, all 255 possible character blocks do not have to be filled in. It 
is advisable that the table starts at the first location in the character 
generator, any gaps left should be filled with zeros. If the character 
generator is being loaded fronn a Basic program then the values in the 
tables are best stored as DATA statements, these values are then 
entered into memon/ using POKE commands, thus: 

20 FOR 1=0 TO 2048 

21 READ A 
22IFA="""THEN30 

23 POKE 5120+ l,A 

24 NEXT 
30EMD 

1 00 DATA 24, 20, 20, 28, 48, 1 1 2, 96, 
1 1 DATA 0, 24,60, 1 26, 255, 24, 36, 66 
120 DATA 255, 1 26, 60, 24, 24, 60, 1 26, 255 
130 DATA ^ 

In the majority of applications alphanumeric characters are 
required in addition to user defined graphics characters, in such cases 
part of the data in the ROM based character generator must be 
transferred to the new RAM character generator. All the alphanumeric 
characters plus the VIC graphics characters (or lower case depending 
on which of the two character generators is accessed) are contained 
in the first 128 characters of the character generator, the remaining 
128 characters are the reverse field versions of the first 128 characters. 
The first 128 characters of the ROM character generator are transfered 
to the new RAM character generator using a combination of PEEK and 
POKE commands thus: 

20 FOR 1 = TO 1024 

30 POKE 5120 + LPEEK(32768+I) 

40NEXTI 

This leaves 128 possible user definable characters starting at 
address 6155, these characters can be filled as described above, and 
will have an ASCII code starting value of 128. An example of the 
routine to enter the character generator data will be as follows: 

20 FOR 1 = TO 1024 

21 POKE 5120=1, PEEK(32768+I) 

22 NEXTI 
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30FORI=0TO 1024 
31 READ A 

32IFA-"*"THEN200 
33POKE6144 = LA 
34 NEXT 

60 REM DATA FOR ASCII CODE CHARACTERS 128, 129, 130 
1 00 DATA 24, 20, 20, 1 8, 48, 1 1 2, 96, 
1 1 DATA 0, 24, 60, 1 26, 255, 24, 36, 66 
1 20 DATA 255, 1 26, 60, 24, 24, 60, 1 26, 255 
130 DATA* 

Having loaded the user definable character generator it can be used, 
it will remain in the VIC until the machine is switched off and can thus 
be used by more then one program. To use the RAM character 
generator two of the 6561 registers must be changed, thus: 

200 POKE 36869, 253 

210 POKE 36866, PEEK(36866)OR128 

Once the user definable RAM character generator has been set up 
and the 6561 registers changed to utilise the new character generator 
it can be used to generate special displays. If POKE commands are 
used to place the characters in the video RAM memon/ then the ASCII 
code value of the new characters is used. If the new characters are 
incorporated into strings then it is essential to know which character 
in the normal character set the new character replaces. This can be 
determined by using the table of VIC ASCII codes and looking for the 
character with the same code value as the new character. When the 
program is written the normal characters are inserted into the string, 
when the program is run they will be automatically replaced by the 
new characters. It is important to note that when using POKE 
commands, the colour RAM location corresponding to the location 
where the character is to be displayed must also be set to give the 
required colour, othenA/ise the display will be white on white and 
therefore invisible. To restore the normal function of the VIC ROM 
character generator use the following two lines: 

500 POKE 36869,240 

510 POKE 36866,150 

High resolution point plotting uses exactly the same principles as 
the generation of user definable characters. It entails filling the video 
RAM with each of the 255 character codes (only half the screen can be 
used with 8x8 characters). The RAM character generator can then be 
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used as a high resolution memory mapped display. If all bytes in the 
RAM character generator are set to zero then the screen is blank. Set 
one bit in one of the characters and a single high resolution dot will 
appear on the screen. The relationship between a single dot on the 
screen, the locations in the RAM character generator, and the code 
value in each of the video memory locations is shown in Figure 17. 
Showing that the basis of high resolution plotting is simply filling the 
video RAM corresponding to the screen area of the high resolution 
display with successive and incremented code values. The rest is a 
matter of calculation to ensure that the correct bits are set in each of 
the eight bytes corresponding to each of the character codes used in 
the video RAM. A high resolution plotting program consists of two 
parts, the initialisation and the point plot subroutine. The 
initialisation sets up the registers of the 6561 for a user definable 
character generator, lowers the top of memon/ to protect that 
character generator, puts the correct data into the video and colour 
RAMs and clears the contents of the RAM character generator. The 
point plot subroutine is called whenever a point is to be plotted or 
erased, and consists of a routine which calculates from given X and Y 
co-ordinates which bit in which byte of the RAM character generator 
is to be set or erased. It should be noted that the area of the screen 
devoted to high resolution plotting can van/ from just a few adjacent 
character spaces to the whole screen (to do this the 6561 is initialised 
to display 8x16 characters rather than the normal 8x8, this requires 
the RAM character generator to be enlarged to 4K. An example of a set 
of Basic routines to plot points in high resolution, plus lines and 
circles, is contained in the following program (these routines use a 2K 
character generator and 8x8 characters so the display occupies only 
half the screen, the 6561 registers have been used to centre the 
display). 
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ASCII code 
value x8 plus 
Character generator 
start address 



00 



Video RAM mapped onto screen 



1 REM ******************************************* 

2 REM *PROGRflM TO PLOT THE GRAPH OF fl FUHCTION 

3 REM *IN HIGH RESOLUTION OH THE VIC 

4 REM ***************:+*if:******.**************** 

5 REM 

6 REM *■ INITIALISE 6561 REGISTERS 
? PRINT"ai" 

S P0KE36.967.. 128 

3 P0KE36865.. 60 

i F C S ;■ =0 •• F (. ) = 1 28 : F < 1 > =64 •' F < 2 > =32 : F < 3 > = 1 6 

20 F ( 4 ) =S • F K 5 ) =4 • F '^ 6 '.> =2 • F <! 7 ) = 1 

30 FORQ=0TO255 

32 POKE7680+Q.. Q 

'■:i4 POKE38480+Q.. 2 

36 NEKTQ 

40 FnRQ=5 1 20TO5 1 20+255*8 

42 P'OKEQ .. 

44 HEXTQ 

45 i- IJKE36869 .. 253 

i€> F 0KE36y66 .. PEEK (. 36366 ) OR 1 28 
47 pn!<E36867., 150 

60 F<E'1 

61 REM -^PLOT GRAPH OF FUNCTION IN LINE 90 
e:2 REM 

30 :~ORC=0TO175 

.'-'0 L=45+40.*S I N ( C,-' 1 > 

31 REM 

32 REM *HIGH RESOLUTION POINT PLOT ROUTINE 

33 REM 
100 A=5120 
110 LR=L/8 
120 LA=INT'::LR::' 
130 H=A+(LA*176> 
140 LR='::LR-LA;:-*8 
300 CR=C,-'8 

310 CA=INT(CR> 

320 A=A+(CA*8> 

325 A=H+LR 

330 CR= I NT < ( CR-CA > *3 ) 

400 POKEA .. PEEK < A > ORF < CR ) 
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500 HEKTC 

550 REM 

551 REM *WHIT FOR KEV PRESS THEN RETURN 

552 REM *SC:REEN TO NORMRL. 

553 REM 

600 GETR* •■ I Fh*= " " THENbOO 
1 000 POKESbSey .. 240 
1010 POKESeSbb.. 150 
1020 POKESbSfe?.. 174 
1 030 P0KE36S65 .. 38 



1 REM **************************************** 

2 REM *PROGRflM TO PLOT HIGH RESOLUTION 

3 REM *POINTS.. LINES AND CIRCLES ON THE VIC. 

4 REM ******•********•**************.********** 

5 REM 

6 REM *INITIflLISE 6561 flND CHhR GEN 

7 REM 

8 P0KE36867.. 128 

9 P0KE36865 .. 60 

1 F ( 8 > =0 : F < > = 1 28 : F < 1 > =64 •■ F ■:.' 2 ) =32 

20 F < 3 > = 1 6 •• F < 4 ':.< =8 ^ F < 5 > =4 ' F •:: 6 > =2 ■ F < 7 .":' = 1 
35 FORQ=0TO255 

37 POKE7680+Q.. Q 

38 POKE38400+Q.. 2 

39 NEXTQ 

40 F0RQ=5 1 20TO5 1 20+255*8 

41 POKEQ.. 

42 NEXTQ 

45 P0KE3686y.. 253 

46 P0KE36S66 .. PEEK ( 36B66 > OR 1 28 

47 P0KE36867.. 150 

90 REM 

91 REM .*riFlTFl FOR LINE DRAW I NO 

92 REM *STflRT AT COORD I NATES >a..Vl 

93 REM *ENri AT COuRniNATES K2..V2 

94 REM 

100 REflIi.H'l..Vl..K2..V2 
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105 IF,'-a=255THEH200 
110 GOSUE1000 
120 GOTO 100 

150 DflTFi 80.. 10. 100.. 40 

1 5 1 DflTH 80 .. 1 .. 60 .. 40 

152 DflTfl 95.. .38.. 95. .30 

153 DflTH 1S5..38.. 65..80 

154 DhTh 65.. 80. 95.. 80 

1 55 DhTh 85 .. 80 .. 85 .. fc"0 
1 ■56 DhTh 90 .. 80 .. 90 .. 60 

157 DhTh 85.. 60.. 90.. 60 

158 DflTH 70.. 75.. 70.. 60 

159 DflTfl 75.. 75.. 75.. 60 

1 60 DflTfl 70 .. 75 .. 75 .. 75 

1 6 1 DflTfl 70 .. 60 .. 75 .. 60 

162 DflTfl r-0.. 50. 70.. 35 

163 DflTfl 75.50.75,35 

164 DflTfl 70.. .50.. 75.50 

165 DflTfl 70.-35.. 75 ..35 

166 DflTfl 85.. 50 ..85.. 35 

1 67 DflTfl 90 .. 50 .. 90 .. 35 

168 DflTfl 85.. 50.. 90. 50 

169 DflTfl 85.. 35.. 90.. 35 

170 DflTfl 20.. 80.. 20. .50 

171 DflTfl 22.. 80. 22. 50 

1 72 DflTfl 1 20 .. 80 .. 1 20 .. 50 

173 DflTfl 122 ..80.. 122.. 50 
138 REM *EHD OF LINE DflTfl 

189 DflTfl 255 ..255 ..255 ..2.55 

190 REM 

191 REM .*DflTfl FOR DRflWIHG CIRCLES 

192 REM *CENTRE AT COORDINATES C^.C't' 

193 REM *RflDIUS R 

194 REM 

1 99 

200 C 
210 G 
220 C 
230 Gi 



^:=21 :CV=40:R=10 
:iSUB3000 

X=121 :CV=35:R=i5 
JSUE3000 



1-40 GETflt: IFA$=""THEN240 
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1009 REM 

1010 REM *LINE DRhWIHG ROUTINE 

1020 REM *USES DflTfi FROM LUiE DflTH TRELE 
030 REM 

200 Kri=;:<;2->-:i 

210 Vri=V2-Vl 

230 H0=1 :h1=1 

240 I F Vri<0THENfi0=- 1 

250 I FKIKOTHENfi 1 =- 1 

270 KE=flES ■:.• KD > ■ VE=FlES < VD > ■ D 1 =XE-'t'E 

280 IFril>=0THEH1320 

290 S0=- 1 ■■ s 1 =0 ■■ LCi= VE : sh=:-:e 

300 I FVri>=0THEHS0= 1 

310 GOTO 1340 

320 S0=0 : S 1 =- 1 •■ LG=>-:E ■• SH=VE 

330 I F>-:ri>=0THEHS 1 = 1 

340 REM 

350 TT=LG • TS=3H • Uri=LG-SH : CR=LG-SH/2 

355 ri=o 

360 REM 

370 i::=Xl :L=Vi :GUSIJB2100 

380 I FCT>=0THEN 1 420 

390 CT=CT+TS - X 1 =K 1 +S 1 ^ V 1 = V 1 +3© 
1410 GOTO 1 460 

1 420 CT=CT-Uri • K 1 =K 1 +fl 1 : V 1 = V 1 +fi0 
1460 TT=TT-1 
1 470 I FTTC0THEHRETURN 
1 480 GOTO 1 370 
2000 REM 

2010 REM *POINT PLOT ROUTINE 
2020 REM *USEri BV LINE flHH CIRCLE DRflW 
2030 REM ^ROUTINES 
2040 REM *C=K COORD I HATE 
2050 REM *L=V COORDINhTE 
2060 REM 
2100 fl=5120 
2110 LR=L/S 
2120 Lfl=INT(LR> 
2130 fl=R+(LH*176) 
2140 LR=<LR-Lfl)*8 
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00 CF-C/S 

10 Ch=INT<CR> 

20 H=H+ ( Cfl*S > 

25 H=fl+LR 

30 CR=IHT':: (CP-Ch>*8) 

400 POKEfl .. PEEK ( R ) ORF ( CR > 

500 RETURN 

600 GETRf ■■ I Ffl:l= " " THEH2600 

000 REM 

001 REM ^CIRCLE DRflWIHG ROUTINE 

002 REM *0>-: FiND OV PRE OFFSET VHRIflBLES 

003 REM *WHICH DETERMINE WHETHER H CIRCLE 

004 REM *0R EL IPSE IS DRPl'JH 

005 REM 

010 U.X-i :0't-1.2 

020 H=2*tr 

030 N= 1 00 

040 INC:=(H-0>,-'N 

050 FOR I =0TOflSTEP I NC 

060 r<=R*s I N ( I > : x= I NT ( ;--;*n ::s-i-c:k+ . 49y > 
070 v=R*cos -:: I > ■• v= I NT -;; v*nv+c V+ . 499 > 

080 L=V • C=X : G0SiJE2 1 BQ 
090 NEKTI 
100 RETURN 

NOTE: For the preceding program the VIC requires, at minimum, a 
3K memory expander cartridge. 
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DISPLAY FORMAT CONTROL 

The standard display format of the VIC is a video display with 22 
characters horizontally and 23 lines vertically, with each character 
consisting of a nnatrix of 8x8 dots. All these values, together with the 
position of the text area in the screen, can be changed by altering the 
contents of specific registers of the 6561. There are five screen fornnat 
variables which can be changed by the user, they are: 

1 — Position of the first colunnn of characters fronn the left hand 
side of the screen. This can be changed by altering the contents of 
control register No. 1., at location 36864, the nornnal value in this 
register is 12. By increasing the value iri the register by two the 
position of the first colunnn of characters is nnoved to the right by one 
character space. The nnininnum value in 36864 is 0, this puts colunnn 5 
of the display area on the left hand edge of the screen, the nnaxinnunn 
value depends on the screen width and varies fronn 22 with a screen 
width of 22 character to 64 with a screen width of 1 colunnn. 

2 — Position of first row of characters fronn the top of the screen. 
This can be changed by altering the contents of control register No. 2., 
at location 36865, the nornnal value in this register is 38. By increasing 
the value in the register by four the display area is nnoved down fronn 
the top of the screen by one line. The nnininnunn value in 36865 is and 
the nnaximunn value 255, a value of greater than 130 will cause the 
display to disappear off the bottonn of the screen and can be used as a 
nneans of screen blanking. 

3 — Deternnine the nunnber of rows in the display. The nunnber of 
rows displayed is deternnined by the value stored in bits 1 to 6 of 
control register No. 4., located at 36867, the nornnal value in this 
register is 174. The value stored in this register is obtained by 
nnultiplying the desired nunnber of rows by two and adding the result 
to the value 128. The nnininnunn nunnber of rows is 1 (register value 
130) and the nnaxinnunn nunnber of rows displayable is 32, — this is 
only achievable if the screen width is reduced so as not to exceed the 
506 bytes in the video RAMs (register value for 32 rows is 192). 
Changing the number of rows in the display to other than 23 will 
disrupt the operation of the screen editor. 

4 — Determine the number of columns in the display. The number 
of columns displayed is determined by the value stored in bits 1 to 6 of 
control register No. 3., located at 36866, the normal contents is 150. 
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The value stored in this register is obtained by adding the minimum 
number of columns desired to the value 128. The minimum number of 
columns is 1 (register value 129), and the maximum number is 27 
(register value 155) this is only achievable if the number of rows is 
reduced so as not to exceed the 506 bytes in the video RAMs. Changing 
the display width to a value other than 22 characters will disrupt the 
operation of the screen editor. 



5 — Determine the size of each individual character matrix. All 
characters are normally displayed as a matrix of 8x8 dots on the 
screen, but changing the value in bit of register No. 4., location 
36867, allows this to be changed to an 8x16 matrix. Add 1 to the 
current contents of this register and the character size will be doubled 
so that it is 16 dots high and 8 dots wide. Return to normal by 
subtracting one. The larger size character matrix is required in high 
resolution point plotting -in order to fill the whole screen with the 255 
characters of the character generator memon/. 
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VIDEO MEMORY ADDRESS CONTROL 

Three areas of processor memory space are required by the 6561 in 
addition to the memon/ locations occupied by the 6561 control 
registers. These three memon/ areas are video RAM, colour RAM, and 
character generator. Of these three the location of the video RAM and 
the character generator are variable and under control of registers in 
the 6561. The starting locations of these two blocks of memon/ are 
stored in control register No. 6., location 36869, plus bit 7 of control 
register No. 3., location 36866. Both addresses are stored in register 
No. 6. as the most significant four bits of a 14 bit address, bit 7 of 
control register No. 3., is address line 9 of the video RAM address. 
Their use is best illustrated by the following sample: 

Control register No. 3. 1 x x x x x x x 

Control register No. 6. 110 1 

14 bit Video RAM address is: 





CRNo. 6 bits 


CR No. bit 




7 6 5 4 7 


xxxx xxxx 


binary — 


1 X 


xxxx xxxx 


hex — 


2 






1 4 bit character generator address is: 





CRNo. 6 bits 
3 2 10 






binan/ — 
hex — 


11 1 X X 
3 4 


XXXX 




xxxx 




In this example the video RAM is located at Hex $0200 and the 
character generator at $3400. The starting position is incremented in 
jumps of 1K for the character generator and 512 bytes for the video 
RAM. The addressing range of both the character generator and the 
video RAM are both limited since to access all the processor memon/ 
space requires a1 6 bit address. This linnitation is partly overcome by 
using hardware addressing, thus the character generator start 
address defaults to $8000 when the contents of all four address bits in 
CR No. 6 which control this address are zero. 
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COLOUR CONTROL 

The VIC has two modes of colour operation, High resolution' mode 
and 'Multicolour' mode. The operating mode employed plus the 
colours used are determined by the contents of control registers No. 
15, and No. 16., of the colour video RAM. The colour video RAM is 
located in a 506 byte block or memon/ starting at location $9600 
(decimal 38400), if there is more than 8K of user memon/ then the 
starting location of colour RAM moves down to $9400 (decimal 
37888). The colour video RAM is only four bits wide, bits 0-2 are used 
to select the character colour and bit 3 is used to determine if that 
character is in 'high resolution' or 'multicolour' mode. 

The 'High resolution' mode is selected by having bit 3 of the video 
colour RAM set to zero, this is the normal mode of operation. In this 
mode there is a one to one correspondence between character 
generator bits and the dots displayed on the screen. This means that 
all 'one' bits will be displayed as dots of one colour and all 'zero' bits as 
dots of another colour. Each character has two colours, a foreground 
(all the 'one' bits) and a background colour (all the 'zero' bits). One of 
these colours is determined by the first three bits of the video colour 
RAM and the other by bits 4-7 of control register No. 16. In normal 
operation the foreground colour is stored in the video colour RAM and 
the background colour which is common to all characters displayed 
on the screen is stored in register No. 16. This can be reversed so that 
all characters have the same foreground colour which is determined 
by register No. 16., and different background colours set by the 
contents of the colour video RAM. Whether a common foreground or 
a common background is selected depends on the contents of bit 3 of 
control register No. 16. If bit 3 is set to 1 then the display will have 
different coloured characters on a common background colour, if bit 
3 = then all characters will have the same colour against a different 
colour background. In addition to the foreground and background 
colours the 6561 allows the colour of the border around the display 
area to be changed, this is selected by bits 0-2 of control register No. 
16. 

The colours which can be displayed on the VIC are divided into two 
groups. The first group has eight colours, these colours can be used 
for the foreground or video colour RAM stored colour, and the border. 
The second group has sixteen colours which can be used for the back- 
ground colour, (stored in control register No. 16.). and for the auxilian/ 
colour (this is only used in the 'Multicolour' mode). The colours 
available in each of the the groups are as follows: 
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Auxiliary/Background 




Colours 





Black 


1 


White 


2 


Red 


3 


Cyan 


4 


Magenta 


5 


Green 


6 


Blue 


7 


Yellow 


8 


Orange 


9 


Light Orange 


10 


Pink 


11 


Light Cyan 


12 


Light Magenta 


13 


Light Green 


14 


Light Blue 


15 


Light Yellow 



Border/Character 
Colours 

Black 

White 

Red 

Cyan 

Magenta 

Green 

Blue 

Yellow 



In sunnnnan/: in 'High resolution' nnode the colours used for a 
particular character are: 



1 — Set bit 3 of register No. 16., for connnnon background or 
connnnon foreground, 
connmon foreground - 
connnnon background - 



POKE 36879,PEEK(36879)AND247 
- POKE 36879,PEEK(36879)OR8 



2 — Set the connmon background/foreground colour in bits 4-7 of 
control register No. 16. There are sixteen possible colours, it is the 
colour nunnber as shown in the above table which is stored in the 
register, as in the following exannple where variable C is the colour 
and is set to a value between and 15: 

POKE36879,PEEK(36879)AND15 
POKE36879,PEEK(36879)OR(C*16) 

return to nornnal with — POKE 36879,27 

3 — Set the border colour in bits 0-2 of control register No. 16. 
There are 8 possible border colours and it is the colour nunnber shown 
in the above table which is stored in the register, as in the following 
exannple where variable C is the colour and is set to a value between 
and 7: 
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POKE 36879,PEEK(36879)AND248 
POKE 36879,PEEK(36879)OR 

4 — Put the colour code for each character to be displayed into the 
corresponding location in the colour video RAM. There are eight 
possible character colours, see above table, they are stored in bits 0-2 
of the 506 locations in the colour video RAM. This is done 
autonnatically in a PRINT statennent where the character colours can 
be ennbedded in the string as colour commands. If POKE commands 
are used to put characters into the video RAM then the colour code 
nnust also be POKEd into the corresponding location in the colour 
RAM. Given the column number — COL, and the line number - LIN, of 
the display plus the ASCII code of the character — A, and the colour 
code for that character — C, the following routine will put the 
character and its colour into the correct locations in the two video 
RAMs: 

100 = LIN*22-hCOL 

110 POKE 38400-hQ,C 

120 POKE 7680-hQ,A 

The 'Multicolour' mode is selected by having bit 3 of the video 
colour RAM set to one. In this mode there is a two to one 
correspondence between character generator bits and the dots 
displayed on the screen. This means that two bits of the character 
generator matrix for that character code correspond to one dot on the 
screen, and the colour of that dot is determined by the two bit code in 
the character generator. Unlike the 'High resolution' mode in which 
only two colours can be displayed for each character, 'Multicolour' 
mode allows four colours per character. However, since two bits of 
character generator data correspond to a single dot on the screen the 
horizontal resolution is half that of the 'high resolution' mode. That is 
each 8x8 character cell in memon/ maps onto an 8x4 character on 
screen (8 lines of 4 dots). Each character occupies the same space in 
either mode since both modes can be intermixed in a display, 
meaning that a single dot in 'Multicolour' mode occupies the same 
space as two horizontal dot positions in the 'High resolution' mode. 
The amount of memon/ required for storage of the 8x4 'm.ulticolour' 
characters is the same as that required for the 8x8 characters, the data 
is simply mapped differently on screen. 

The 'Multicolour' mode is not suitable for use with the ROM based 
character generators but can be ven/ effective when used with a user 
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definable RAM character generator. This is because the ROM 
character generators are designed for 'High resolution' mode displays 
where each bit in the character matrix represents a dot position on the 
screen. In 'Multicolour' mode the character generator contains the 
colour of each dot by using two bits to represent each display dot. 
With a ROM character generator most characters will thus appear as 
an array of different coloured points rather than a character. See the 
section on "6561 Display Modes" for information on the use of user 
definable RAM character generators and high resolution point 
plotting. 

In 'Multicolour' mode the two bits of the character generator 
character matrix which represent each screen dot select one of four 
colours for that dot. The four codes created by these two bits tell the 
6561 where to find the colour information for the dot. The two bit code 
is not itself a colour code, it is simply a pointer to four different colour 
codes, giving greater flexibility, as each code pointed to has either 3 
or 4 bit resolution. The use of a simple two bit pointer, combined with 
bit 3 of the colour video RAM being used to determine the colour 
display mode means that it is possible to freely intermix 'High 
resolution' and 'Multicolour' characters in a display. The colour of the 
dot can be either the background colour, the foreground colour, the 
exterior border colour or a special auxilian/ colour (information on 
which is stored in bits 4-7 of control register No. 15.). The 'Multicolour' 
mode select codes are: 

— Background colour 

1 — Exterior border colour 

1 — Foreground colour 
1 1 — Auxilian/ colour 

The use of the 'Multicolour' mode can be summarised using the 
following example: 

1 — Set the background colour to one of 16 colours, this colour 
code is stored in the following example in variable C which will have a 
value between Oand 15: 

POKE 36879,PEEK(36879)AND15 
POKE 36879, PEEK(36879)OR(C*16) 

2 — Set the exterior border colour to one of 8 colours, this colour 
code will have a value between and 7 and in the following example is 
stored in variable C: 
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POKE 36879,PEEK(36879)AND248 
POKE 36879,PEEK(36879)ORC 

3 — Set the foreground colour to one of 8 colours by POKEing the 
colour code into the colour video RAM location, corresponding to the 
location of the displayed 'Multicolour' character. Since it is bit 3 of the 
colour video RAM which deternnines whether a character is displayed 
in 'High Resolution or Multicolour nnode then 8 should be added 
to the colour code values for all characters to be displayed in 
'Multicolour' mode. 

4 — Set the auxilian/ colour code to one of 16 colours, this colour 
code will have a value between and 15 and in the following exannple 
is stored in variable C: 

POKE36878,PEEK(36878)AND15 

POKE36878,PEEK(36878)OR(C*16) 
NOTE: Bit 3 of control register No. 16 has no function in 'Multicolour' 
nnode but should be set to the nornnal value of 1, unless otherwise 
required when internnixing both colour display nnodes. 

5 — Set up the character generator nnatrix for each character to be 
displayed, thus: 

bit 
byte 7 6 5 4 3 2 10 


1 
2 
3 
4 
5 
6 
7 

This exannple is for a character in a user definable character generator 
starting at location 5120, the character has a code value of and 
shows each of the four colours available in nnulticolour nnode 
characters thus: 






1 


1 


1 1 





1 


1 


1 1 





1 


1 


1 1 





1 


1 


1 1 














1 


1 


1 


1 


1 


1 


1 


1 


1 1 


1 1 


1 1 


1 1 



Hex 


Location 


IB 


5120 


IB 


5121 


IB 


5122 


IB 


5123 


00 


5124 


55 


5125 


AA 


5126 


FF 


5127 
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byte 

1 
2 
3 
4 
5 
6 
7 




Hex 


Location 


IB 


5120 


IB 


5121 


IB 


5122 


IB 


5123 


00 


5124 


55 


5125 


AA 


5126 


FF 


5127 
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Sound Locations 
The sound locations nnust be POKEd with nunnbers between 128 
and 255. The frequency rises as the nunnber, with the exception of 255 
which is a low frequency. Each tone location produces one voice. A 
in any byte will turn that voice off. The following decinnal codes 
produce an approxinnation of three octaves of the even-tennpered 
nnusical scale. The scale is relative, not absolute concert pitch. This 
table lists the musical note and its respective POKE location. 

Poke locations of Musical Notes 



Musical Note 


Poke 


C 


128 


C* 


134 


D 


141 


D# 


147 


E 


153 


F 


159 


V*f 


164 


G 


170 


G* 


174 


A 


179 


A# 


183 


B 


187 


C 


191 


C^ 


195 


D 


198 


D*^ 


201 


E 


204 


F 


207 


V** 


210 


G 


213 


G*" 


215 


A 


217 


^*^ 


219 


B 


221 


C 


223 


C# 


225 


D 


227 


^« 


228 



E 


230 


F 


231 


F'* 


232 


G 


234 


G# 


235 


A 


236 


^tf 


237 


B 


238 


C 


239 


C# 


240 
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THE 6561 SOUND GENERATORS 

The sound effect or music generation capabilities of the VIC are 
controlled by five registers in the 6561. Four of the registers are 
associated with sound generation, the fifth controls the volume of the 
sound output. Each of the four sound generation registers has an 
associated oscillator, the register contents determine the frequency 
of the oscillator output. The frequency is determined by van/ing the 
pulse width, the output from all four oscillators is a symmetrical 
square wave. The outputs are combined to give the audio input to the 
TV display, where the sound is generated via the TV speaker. One of 
the four audio oscillators acts as a variable frequency noise source 
and the other three generate a simple tone. The five control registers 
used are: 

Audio oscillator No. 1. — control register No. 11., location 36874. 
Bits 0-6 control the frequency, bit 7 turns the oscillator on (=1) or off 
(=0). Low base frequency, thus = value of 128 put in this register will 
produce the lowest frequency sound of any of the three audio 
oscillators. 

Audio oscillator No. 2. — control register No. 12., location 36875. 
Bits 0-6 control the frequency, bit 7 turns the oscillator on (=1) or off 
( = 0). The base frequency for this oscillator is between that for audio 
oscillators No. 1 ., and No. 3. 

Audio oscillator No. 3. — control register No. 13., location 36876. 
Bits 0-6 control the frequency, bit 7 turns the oscillator on (=1) or off 
( = 0). This has the highest base frequency of the three oscillators. 

Noise generator — control register No. 14, location 36877. Bits 0-6 
control the base frequency of the noise generator, bit 7 turns it on 
( = 1) or off (=0). This is a pseudo white noise generator, giving a 
random sequence of pulses with a frequency determined by the 
contents of the control register. 

Volume control — control register No. 15., location 36878. The 
volume of the composite audio signal produced when one or more of 
the four audio oscillators is turned on is controlled by bits 0-3. 

Each of the audio oscillators is capable of generating 128 different 
frequencies and each oscillator is different, thus oscillator No. 1., can 



144 



be described as a 'base' sound generator, No. 2., as a 'Tenor' and No. 
3., as a 'soprano'. The combined audio output has one of sixteen 
volume levels. 

The four sound generators can be used to create a wide range of 
sound effects for use in games programs, they can also be used to play 
music. Writing routines to create sound effects is simply a matter of 
experimentation. Try to analyse the required sound and then re-create 
it using a combination of the four audio oscillators and the volume 
control, this is demonstrated in some of the following examples; 



5 REM *rinKES a sound like the singing 

6 REM .*0F BIRDS 

? REM 

10 rOKE3687S.. 15 

20 FORL=1TU20 

30 FORM=254TO240+ 1 NT < RND •: 1 ;:• * 1 8 > STEP- 1 

40 P0KE3bS76,.M 

50 HE^<m 

o P K E 3 6 & 7 6 .• 

70 F0RM=9T0 1 NT ( RND ':; 1 > * 1 m > + 1 20 

30 NEKTM 

98 NEKTL 

100 GOTO 10 



5 REM*MHKES fl SOUND LIKE THE RINGING OF 

6 REM*fl TELEPHONE 

7 REM 

10 P0KE3bS73.. 15 

20 F0RL=1T05 

30 FURM=^1TO50 

-UZi P0KE3fc"S7t".. 230 

50 FURN=1T05 

60 NEKTN 

70 P0KE36876 .■ 8 

30 HEKTM 

i^O FnRM= 1 TO3000 

180 HE^^TM 

110 NEKTL 

120 P0KE36878.. 
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i REM ;4fMHKES h SOUND LIKE H GhLLOPING 

2 REM :*HORSE.. THE SOUND RECEDES INTO THE 

3 REM .*DISThHCE. 

4 REM 

5 FORK=15TO0STEP-1 
S !-0RZ=iTu4 

7 H=60 

10 P0k:E36y78..y 

20 rOKE3feS76.. 230 

30 FUKE36876.. W 

40 FuRQ=lTOfl-HEyTQ 

50 P0KE3b87^S,. 230 

60 PUKE36S76.. 

70 FuRQ= 1 TOP) •• NE>:TQ 

1 1 P0KE3;687S .. I NT < K/2 > 

120 PuKE3687t... 230 

130 PUKE36876.. 

140 F0RQ=1T0h:NEXTQ 

lb0 P0KE36876.. 230 

1 60 P0K'E36S76 .. 

1 70 FORQ= 1 Tu4*fi : NEXTQ 

180 he:>^:t.z 

190 HEKTX 



1 R 

2 R 

3 R: 



EM 
EM 
EM 



*MHKES R SOUND 
*fi GRFlNDFflTHER 



LIKE THE 
CLOCK 



TICKING OF 



h- 



y0 



ly 
20 
30 



40 
50 



7tf 
80 



P0KE36878.. 15 
P0KE36876 .. 230 
POKE36876..0 
FORQ=lTOfl:NEXTQ 
P0KE3e.876 .. 236 
P0KE36S76.. 
FORQ=lTnH-NEXTQ 
GUTO20 



146 



5 REM *-MflKES Fi SOUND LIKE THE EREhKDJG 

6 REM *0F WAVES OH fl SEASHORE 

7 REM 

1 8 P0KE3i5S77.^ iSO 

20 FORL=lTOiO 

30 D=^INT';:RNri<l>*5)*50+50 

49 F0RM=3T015 

50 P0KE3637S..M 
SO FURH=1T0D 

"■?ru L n"'..'-rt | 

3& NEXTM 

98 FuRM^15Tn3STEP-l 

10U P0KE3b8?8.. M 

lliJ FURHr.iTnri 

126 HEXTN 

130 NEXTM 

140 NEXTL 

150 PUKE36878.0 

160 pnKE36377;0 

200 GOTO 10 



Using the audio generators on the 6561 to play nnusic requires some 
thought otherwise the result will sound ven/ abrasive and not ven/ 
satisfacton/. The first problem is that the square wave output from 
the audio oscillators produces a rather unpleasant set of harmonics 
which gives the note a rough sound. Only external electronics can 
change the shape of the waveform, but by using two audio oscillators 
to produce the same note of frequencies about an octave apart a 
more pleasing sound is produced. The second problem is to generate 
the correct attack and decay for the instrument, this is done by 
changing the amplitude of the output during the generation of each 
note. These two ideas are illustrated in the following program which 
plays scales, the sound resembles a piano. 
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1 REM *PLHVS fl REPEAT I HG OCTAVE SCALE 

2 REM *THE SuUHri OF EACH NOTE DECAVS AND 

3 REM *THUS SOUNDS MORE LIKE H PIANO THAN 

4 REM *AN ELECTRIC ORGAN 

5 REFlDA •■ I Fh= 100THEN 1 56 
iO PuKE3fc374,H 

20 PuKE3fc875.. A 

30 FORQ=-- 1 5TO0STEP- 1 

40 PUKE36S7S.. Q 

50 PqRX=lTO50:NE;KTX 

30 HLXTQ 

LOO G0T05 

1 50 RESTORE •• GOTOS 

200 n ATH223 .. 22? .. 236 .. 23 1 .. 234 .. 236 .- 23S .. 239 

2 1 riATH239 .. 23S .. 236 .. 234 .. 23 1 .. 230 .. 227 .. 223 .. i 06 



To play a musical score requires a note table, this table contains 
each note in the score in the form of the value to be placed into the 
audio oscillator register and the duration of that note. 
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1 52 - Vic I /O Ports and the 6522 

160 - Operation of I/O Ports 

164 — Interval Timers and Counters 
of the 6522 

173 - Shift Register of 6522 

177 — Interrupts 

181 — Function Control 



cc 
O 

Q_ 

DC 
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CO 
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> 

CN 
CN 
LO 
CO 
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CQ 



INTERRUPT 
CONTROL 



00 

I 

DD 

O 
O 

Q. 

CQ 



CD 
C^ 
C7I 
N> 
N> 

< 
CD 

— ^ 
V) 



CD 

5" 
i-t- 

CD 
-+i 
Q) 
O 
CD 

> 
Q. 

■a 



o 

3- 



3 



DATA 

BUS 

BUFFERS 



r/wv , 


CHIP 
ACCESS 
CONTROL 




rs 1 1 


rT? 1 


HS fi 1 


H<; 1 p 


RS 7 , 


RSI J 





D- 



PERIPHERAL 



AUXILIARY 



FUNCTION 
CONTROL 



LATCH HIGH 



COUNTER HIGH 



LATCH LOW 



^ COUNTER HIGH | LOA 



INPUT 
LATCH 



PORT A 
REGISTERS 



HANDSHAKE 
CONTROL 



.ZP 



INPUT 
LATCH 



DATA DIR 



PORT B 
REGISTERS 



"^ PORT A 



-►CA1 
CA2 



C "> PORT 



THE VIC I/O PORTS AND THE 6522. 

The VIC communicates with the user, and with peripheral devices, 
via three integrated circuits. The most important of the three is the 
6561 VIC chip, looked at in detail in the previous section. The chip 
controls the video display, sound generation plus the peripheral 
devices, a light pen and a joystick. The other two integrated circuits 
are 6522 Versatile Interface Adapters or VIAs and these are used to 
perform all other I/O functions of the VIC. We can summarise the 
function of these two chips as follows: 

Keyboard input 

User port 

Cassette deck 

Senal I/O — cut down IEEE 488 port 

RS232 I/O — for pnnters modems etc. 

Restore key (NMI line) 

Joystick — simple switch type 

Light pen control 

IRQ timing for real time clock and keyboard 
The two VIA chips which are used to control all these functions have 
between them just 32 programmable I/O lines and eight handshake 
lines. Many of these lines are used by more than one of the above 
functions. 

An understanding of the two 6522 VIA interface chips is essential if 
all the features of the VIC are to be used to the full, and a knowledge of 
these chips helps to explain some of the quirks of the system. The 
functioning of these chips is controlled by internal programmable 
registers, there are sixteen registers in each chip. These 32 registers 
(sixteen from each chip) are located in addressable memon/ space and 
are located at hex $9110 - $912F (decimal 37136 to 37168). They can 
thus be accessed from Basic using PEEK and POKE statements and 
from machine code using LDA and STA commands. 

Of the 40 I/O lines output from the two VIA chips, the user can 
directly connect equipment to, and control the functioning of, 23 
lines, the other 17 lines are used by the keyboard and are not therefore 
usable. All but one of the I/O lines on VIA No. 1 ., can be used, but only 
five of the lines on VIA No. 2., VIA No. 1., is thus used in all the 
examples in this section. The functions of each I/O line from the two 
VIA chips is shown in Figure19, the electrical connections which allow 
the user to utilise some of these lines is shown in Figures 20 to 24 
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VIA « 1 
NMI 



CAl 


PAO 


PA 1 


PA 2 


PA 3 


PA 4 


PA 5 


PA 6 


PA 7 


CA2 



RESTORE 



SERIAL CLK (IN) 
SERIAL DATA (IN) 
X)Y0 
JOY 1 
JOY 2 

LIGHT PEN 
CASSETTE SWITCH 
SERIAL ATM (OUT) 

CASSETTE MOTOR 



VIA tt2 
IRQ 



CAl 


PAO 


PAl 


PA 2 


PA 3 


PA 4 


PA 5 


PA6 


PAT 


CA2 



CASSETTE READ 



ROW 

INPUT 



SERIAL CLK (OUT) 



CBl 


\ 


PBO 




PBl 




PB2 




PB3 




PB4 




PB5 




PB6 




PB7 




CB2 


y 



$9110 

4 
S911F 



USER 
PORT 



CBl 


SERIAL SRO (IN) 


PB0 




PBl 






PB2 




COLUMN 


PB3 




OUTPUT 


PB4 






PB5 






PB6 






PB7 


^^ JOY 3 


CB2 


SEF 


lAL DATA (OUT) 



$9120 

i 
$912F 



Fig. 19 — Allocation of the I/O lines fronn the two 6522 chips. 



Though these lines are all assigned particular functions the user is not 
confined to using a particular I/O line for the function designated for 
that line. This is because all the I/O lines are under software control, 
and It IS not until the routines, within the operating systenn which 
utilise that line, are called for a particular function, that that line is 
used. This flexability allows the re-definition of I/O line function and is 
one of the nnost useful features of the VIC. 

A block diagrann of the 6522 is shown in Figure 18, a ven/ connplex 
chip, with sixteen different addressable registers. Each bit within 
these registers has a specific function, either as an input, an output or 
to control the operation of the 6522. A mennon/ nnap of the 
addressable registers of the two chips is shown in Figure 8, the 
registers are of six basic types; I/O data direction, peripheral control, 
shift register, tinners and tinner control registers. 

The diagrann in Figure18 can be divided into two, on the left are the 
connections to the processor, the processor interface. On the right the 
outputs of the 6522, or the peripheral interface. The nnain connponents 
of the processor interface are the eight bi-directional data lines. These 
are connected directly to the processor data bus and are used to 
transfer data between the VIA and the processor. As with any 
nnennon/, the processor treats the 6522 as a sixteen byte block of 
nnennory, the direction of data transfer is controlled by the R/W line, 
the exact tinning of a transfer being controlled by the 02 clock line. The 
individual registers are addressed by the register select lines 
connected to the bottonn address lines AO — A3. The exact location of 
the 6522 within nnennon/ space is deternnined by de-coding sonne of 
the address lines and connecting these to the chip select inputs. The 
registers of the 6522 will only be accessed if chip select CS1 is high and 
CS2 low. As with all the I/O chips the 6522 can generate a processor 
interrupt by pulling the IRQ line low. This occurs whenever an internal 
interrupt flag is set as a result of an input on one of the peripheral 
control lines. 

The processor interface lines have seven basic functions which can be 
sunnnnarised as follows: 

1 — Phase Two Clock (02) — data transfers between the 6522 and 
the processor take place only when the 02 clock is high. This clock also 
acts as a tinne base for the internal 6522 tinners and shift register. On 
the VIC the 02 clock is derived from the 6561 video interface chip and 
has a frequency of MHz 1 .1 082. 
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1) Game I/O 4) Serial I/O 

2) Memory Expansion 5) Cassette 

3) Audio and Video 6) User Port 

Fig. 20 - Position of the different VIC I/O outputs. 



USER I/O 



1 2 3 4 5 6 7 8 9 10 11 12 



ABCDEFHJ KLMN 



PIN# 


TYPE 


NOTE 


PIN# 


TYPE 


NOTE 


1 


GND 




A 


GND 




2 


+ 5V 


1(WmA MAX. 


B 


CB1 




3 


RESET 




C 


PBQ) 




4 


JOYO 




D 


RBI 




5 


J0Y1 




E 


PB2 




6 


J0Y2 




F 


PB3 




7 


LIGHT PEN 




H 


PB4 




8 


CASSETTE SWITCH 




J 


PBS 




9 


SERIAL ATN IN 




K 


PB6 




10 


+ 9V 


1(WmA MAX. 


L 


PB7 




11 


GND 




M 


CB2 




12 


GND 




N 


GND 





Fig. 21 — The allocation and function of pins on the User Port connector. 
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2 — Chips Select Lines (CS1, CS2) — the two, chip select inputs are 
connected to the processor address bus. CS1 is connected directly to 
a low address line, in VIA No. 1., to A4 and in VIA No. 2., to A5. CS2 is 
connected in both VIA chips to a decoded address derived fronn 
address lines A10 to A15. CS2 determines the starting address as 
$9100, and CS1 is the offset so that VIA No. 1., starts at address $9110 
and VIA No. 2., at $9120. Note that the 6522 registers can only be 
addressed when CS1 is high and CS2 is low. 

3 — Register Select Lines (RSO, RSI, RS2, RS3) — the four register 
select lines are connected to the processor address bus lines AO — A3. 
This allows the register to select one of the sixteen registers in the 
6522. 

4 — Read/Write Line (R/W) — the direction of data transfer 
between the 6522 and the processor is controlled by the R/W line. If 
R/W is high then a 'read' operation is performed and data is transferred 
from the 6522 onto the data bus. If R/W is low then a 'write' operation 
is performed and data currently on the data bus is loaded into the 
addressed register of the 6522. 

5 — Data Bus (DBO to DB7) — data is transferred between the 
processor and the 6522 via the eight bi-directional lines of the data 
bus. The internal data bus of the 6522 will only be connected to the 
processor data bus when the two chip select lines are enabled and the 
02 clock is high. The direction of data transfer will depend on the state 
of the R/W line and the register addressed on lines RSO to RS3. 

6 — Reset (RES) — the reset line clears all the internal registers of 
the 6522 (except the timers and shift register) and sets them all at 
logic zero. Resulting in all the interface lines put in the input state, and 
timers shift registers and interrupts are all disabled. This is connected 
to the processor power up circuitn/ and is only used when the system 
is switched on (this line is accessable externally and since the system 
software can be changed its function could be modified). 

7 — Interrupt Request (IRQ) — the interrupt request output from 
the 6522 is very important in the VIC. The IRQ line goes low whenever 
an internal interrupt flag is set and the corresponding interrupt flag is 
high. On VIA No. 1., the IRQ line is connected to the processor NMI 
interrupt line, this is used to test the RESTORE key which is connected 
to the CA1 line of the VIA, an IRQ signal is produced if this line is 
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SERIAL I/O 




PIN # 


TYPE 


1 


SERIAL SRQ IN 


2 


GND 


3 


SERIAL ATN IN/OUT 


4 


SERIAL CLK IN/OUT 


5 


SERIAL DATA IN/OUT 


6 


NC 



Fig. 22 - The allocation and function of pins on the Serial I/O 



connector. 



AUDIO/VIDEO 




PIN # 


TYPE 


NOTE 


1 


4-6V 


1(3mA MAX 


2 


GND 




3 


AUDIO 




4 


VIDEO LOW 




5 


VIDEO HIGH 





Fig. 23 — The allocation and function of pins on the Audio/Video connector. 









GAME I/O 








] 




2 




3 




4 




5 


o 


o 

6 







7 


O 


o 

8 


O 


o 

9 


O 



N # 


TYPE 
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JOY0 


2 
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J0Y2 
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Fig. 24 — The allocation and function of pins on the Game I/O connector. 
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brought low (key depressed). On VIA No. 2., the IRQ line is connected 
to the processor IRQ line, the function of this line is to generate a 
regular 60 Hz interrupt which is used by the clock, I/O and keyboard 
routines, this interrupt is provided by Tinner 1 in the VIA. 

The peripheral interface lines are divided into two I/O ports, each 
port having eight bi-directional I/O lines and two control lines. The 
function of each of the four ports on the VIC are shown in Figure 3. The 
following is a brief discription of the I/O buses and control lines of a 
6522: 

1 — Peripheral A Port (PAO — PA7) — this port consists of eight 
bi-directional lines each of which can be independently programmed 
under control of the Data Direction Register to act as either an input or 
an output. The polarity of the lines defined as outputs is controlled by 
the contents of the Output Register. Data input on those lines defined 
as inputs can be latched into an internal register under control of the 
CA1 line. The internal control registers are used by the processor to 
control the modes of operation of the 6522. All lines represent a load 
of one standard TTL gate in the input mode and will drive one 
standard TTL load in the output mode. 

2 — Penpheral A Control Lines (CA1, CA2) — the two peripheral 
control lines act as interrupt inputs (as in the RESTORE key) or as 
handshake outputs (as in serial clock output). Each line controls an 
internal interrupt flag with a corresponding interrupt enable bit. In 
addition CA1 controls the latching of data on peripheral port A input 
lines. The various modes of operation are control registers of the 
6522. CA1 is a high impedence input only while CA2 is either an input 
or an output. In the input mode CA2 will source one standard TTL load 
and in the output mode will drive one standard TTL load. 

3 — Peripheral B Port (PBO — PB7) — this port consists of eight 
bi-directional lines each of which can be independently programmed 
under control of a Data Direction Register to act as either an input or 
an output. The operation and electrical characteristics of Port B is the 
same as Port A. In addition when line PB7 is in the output mode it's 
polarity can be controlled by one of the internal timers. The second 
timer can be used to count pulses on line PB6 when that line is in the 
input mode. 

4 — Peripheral B Control Lines (CB1, CB2) — these two penpheral 
control lines have the same functions and electncal charactenstics as 
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control lines CA1 and CA2. They also have the additional function of 
acting as a serial port under control of the internal shift register of the 
6522. 
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OPERATION OF THE I/O PORTS 

Three registers are required to access each of the eight line 
peripheral ports, they are a Data Direction register, an Output register 
and an Input register. Each port has a Data Direction register for 
specifying whether each of the eight lines acts as either an input or an 
output. A zero in bit of the Data Direction register causes the 
corresponding peripheral line to act as an input. A one causes the line 
to act as an output. 

Example: Set lines to 3 as inputs and 4 to 7 as outputs on Port B of 
VIA No. 1. 
I/O line 
number 



1 

2 

3 

4 

5 

6 

7 

Total for example — 240 

Command is — POKE 371 38,240 

Each peripheral line is connected to an Input register and an Output 
register. When a line is programmed to act as an output the voltage on 
that line is controlled by the corresponding bit in the Output register. 
A '1' in the Output register causes the corresponding line to go 'high', 
and a '0' causes it to go'low'. 

Example: output to port B of VIA No. T, using the data direction set 
out in the previous example, lines 4 and 7 are high and lines 5 and 6 are 
low. 

'high' or value of line 

'low' in I/O reg 



'high' 16 



data 


DDR contents 


DDR contents 


direction 


if line = in 


for example 


in 


1 





in 


2 





in 


4 





in 


8 





out 


16 


16 


out 


32 


32 


ou 


64 


64 


out 


128 


128 



I/O line 


data direction 


number 


of line 





in 


1 


in 


2 


in 


3 


in 


4 


out 



160 



5 


out 


'low' 





6 


out 


'low' 





7 


out 


'high' 


128 



Total for example — 1 44 



Command IS — POKE 37136,144 



Reading one of the peripheral port registers causes the contents of 
the Input register to be transferred onto the data bus. With input 
latching disabled the contents of the Input registers will always 
reflect the data currently on all the peripheral port lines. 

Examples: read the contents of the input lines of port B of VIA No.1., 
set up in the example on data direction, store the contents as variable 
A. 

A= PEEK(37136)AND15 

the AND 15 masks off the lines used as outputs, they must be 
removed since the current state of the output lines is stored in the 
input register. AND commands can then be used to determine which 
lines are 'high' and which are 'low', thus to determine the state of line 
use: 

1 X = A AND 2 : REM line 2 = AND 4, line 3 - AND 8 etc 

20IFX = 0THEN40 

30 PRINT "Line 1 is 'high" :END 

40 PRINT "Line 1 is'low":END 

If input latching is enabled then input register A will reflect the 
contents of all the lines on Port A prior to the setting of the CA1 
interrupt flag by an active transition on CA1 . 

There is a slight difference in the operating of Port A and Port B. 
Both operate in the same manner, however, for the output lines of 
Port B the corresponding bits in the Input register will contain the 
contents of the corresponding output register bit instead of the data 
on that line. This allows proper data to be read into the processor if 
the output line is not allowed to go to the full voltage. Thus if an 
output line is tied to ground or zero voltage then that line will always 
be at a logic zero irrespective of the contents of the corresponding 
Output register bit. In Port A this bit will always be '0' in the Input 
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register but in Port B it will contain the contents of the corresponding 
bit in the Output register. With input latching enabled on Port B, 
setting the CB1 interrupt enable flag will cause the Input register to 
latch this connbination of input data and Output register data until the 
interrupt flag is cleared. 

Registers Used in Operation of the I/O Ports. 

Register 1 — Parallel port B I/O register 
VIA No. 1 —Hex $9110 decimal 37136 
VIA No. 2 — Hex $91 20 decimal 371 52 

This register contains the contents of the input and output lines of 
port B of the 6522, Reading 

CB2 interrupt flag to be reset. 

Register 2 — Parallel port B I/O register with handshake control. 
VIA No. 1 —Hex $91 11 decimal 37137 
VIA No. 2 — Hex $9121 decimal 371 53 

This is one of two registers which contain the contents of the input 
and output lines of port A. The two registers are identical except that 
this register has control over the handshake lines. Data input using 
the CA1 line to latch the input into the I/O register will set the CA1 
interrupt flag. This flag is cleared by reading the contents of register 
No. 2. 

Register 3 — Data direction register for port B 
VIA No. 1 —Hex $91 12 decimal 37138 
VIA No. 2 — Hex $91 22 decimal 371 54 

This register controls each of the eight lines on Port B and 
determines whether they are acting as inputs or outputs. A 'one' in 
any of the eight bits of this register sets the corresponding line into 
the output mode, and a 'zero' puts it into the input mode. 

Register 4 — Data direction register for port A 

VIA No. 1— Hex $91 13 decimal 

VIA No. 2 — Hex $91 23 decimal 371 55 

This register controls each of the eight lines on port A and 
determines whether they are acting as inputs or as outputs. A one in 
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any of the eight bits of this register sets the corresponding line into 
the output mode and a zero puts it into the input nnode. 

Register 16 — Parallel port A I/O register 
VIA No. 1 — Hex $91 1 F decimal 371 51 
VIA No. 2 — Hex $91 2F decimal 371 67 

This is the second of the two registers containing the contents of 
the input and output lines or port A. This register has no control over 
the handshaking lines. The direction of the data transfer in this port is 
controlled as in the other port A register by the contents of Data 
direction register A. 
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THE INTERVAL TIMERS AND COUNTERS OF THE 6522 

The 6522 has two internal tinners, one of which can also function as 
a counter of pulses input on one of the I/O lines. These tinners are not 
only useful but of vital importance to the operation of the VIC. It is 
these tinners which are used to control the generation of the 60 Hz 
interrupt used to update the real time clock and scan the keyboard. 
They are also used to control the timing of I/O on the senal port, the 
RS232 port and the cassette. Since the VIC interface uses two 6522 
chips there are a total of four timers available for use by the system 
software. The timers are used in conjunction with the processor 
interrupts, the following table shows some of the functions of each 
timer plus the interrupt line affected: 

VIA No. 1 NMI interrupt 

Timer 1 — RS232 port I/O timing 
user port operation 

Timer 2 — RS232 port I/O timing 
user port operation 

VIA No. 2 IRQ interrupt 

Timer 1 — System 60 Hz interrupt 

real time clock updating 
keyboard scanning 
Cassette read/write timing 

Timer 2 — Cassette read/write timing 
Serial port timing 

Note that Timer 1 of VIA No. 2., is used for both updating the real time 
clock and cassette timing, for this reason the real time clock looses 
whenever the cassette is used. 

Inten/al Timer 1 consists of two eight bit latches and a sixteen bit 
counter, these occupy four of the 6522 registers, registers number 5 to 
18. Their location in the VIC are as follows: 

Register 5 — Timer 1 counter low order byte 

VIA No. 1 — Hex $91 14 decimal 
VIA No. 2 — Hex $91 24 decimal 
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Registers — Timer 1 counter high order byte 

VIA No. 1 — Hex $91 1 5 decimal 37141 
VIA No. 2 — Hex $9125 decimal 371 57 

Register 7 — Timer 1 latch low order byte 

VIA No. 1— Hex $91 16 decimal 37142 
VIA No. 2 — Hex $9126 decimal 371 58 

Registers — Timer 1 latch high order byte 

VIA No. 1 — Hex $91 1 7 decimal 37143 
VIA No. 2 — Hex £91 27 decimal 371 59 

The latches are used to store data to be loaded into the counter. 
After loading, the counter decrements at the system clock rate (MHz 
1.1082). Thus if the counter is loaded with its maximum value (all 
sixteen bits = or decimal 65,535) it will be decremented to zero in 
.0591 seconds. Upon reaching zero, an interrupt flag is set and one of 
the two interrupt lines will go low and generate a processor interrupt. 
The timer will then disable any further interrupts, or automatically 
transfer the contents of the latches into the counter and continue to 
decrement. In addition the timer can be instructed to invert the output 
level on one of the peripheral I/O lines each time it 'times out'. The 
modes of operation are controlled by reading or writing to the four 
timer registers, plus the auxilian/ control register and the two 
interrupt registers. 

The processor can only load data directly into three of the four 
registers of Timer 1, these registers are the high order and low order, 
latch registers and the high order counter register. The low order 
counter register can only be loaded by an automatic process, which 
takes the contents of the low order latch and stores it in the low order 
counter register when the processor writes to the high order counter 
register. The following commands would have these effects on Timer 
1 of VIA No. 1: 

POKE 37140, 255 :put 255 into the low order latch. 
POKE 37141 , 255 :put 255 into the high order latch. 

then transfer to high order counter then transfer 
low order latch into low order counter, 
and reset the Timer 1 interrupt flag. 
POKE 37142, 255 :put 255 into the order latch 
POKE 37143, 255 :put 255 into the high order latch and reset 
the Timer 1 interrupt flag 
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All four Timer 1 registers can be read using PEEK or similar 
commands, reading each of these registers of VIA No.1., has the 
following effects: 

A = PEEK(37140) :read contents of low order and reset Timer 
1 interrupt flag. 

A = PEEK(37141) .read contents of high order counter 

A= PEEK(37142) ; read contents of low order latch 

A= PEEK(37143) : read contents of high order latch 

The four operating modes of Timer 1 are controlled by two bits in 
the Auxilian/ Control Register. This register is register No. 12., of the 
6522 and is located at address $91 1B (decimal 37147) for VIA No. 1., 
and $91 2b (decimal 37163) for VIA No. 2. Bits 6 and 7 of the Auxilian/ 
Control register (for ACR) are used to control the operating modes of 
Timer 1, these four modes can be divided into two groups each of two 
modes, the one shot modes and the free running modes. The Auxilian/ 
Control Register is also used to control the output by Timer 1 of pulses 
on peripheral I/O line PB7 of the VIA. However, to output pulses on 
PB7 requires that the Data Direction Register for Port B line 7 is set to 
'1' so that this line is in the output mode. Setting bit 7 of the ACR will 
then ensure that peripheral line PB7 is under control of Timer 1. Line 
PB7 is set into the output mode by the following command. 

POKE 37138, PEEK (37138) AND 127 OR 128 

Bits 6 and 7 of the ACR are used to control the operating modes as 
follows: 

ACR bit 6 — '0' = enable one shot mode 

'^' = enable free-running mode 

ACR bit 7 — '0' = disable output on PB7 
'1 ' = enable output on PB7 

The four operating modes formed by combinations of these two 
bits can be obtained by using PEEK and POKE commands plus logical 
operators, thus for VIA No. 1 ., the modes and commands are: 

ACR6 = '0' ACR7 = '0' 

Mode function — Generate a single time-out interrupt on (NMI) 
each time Timer 1 is loaded. Output of PB7 by Timer 1 is disabled. 
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POKE 37147, PEEK(37147) AND 63 
ACR6= '0' ACR7= '1' 

Mode function — Generate continuous interrupts, the spacing 
between interrupts being deternnined by the contents of Tinner 1. 
Output on PB7 by Tinner 1 is disabled. 

POKE 37147, PEEK(37147) AND 63 OR 64 

ACR6= '1' ACR7 = '0' 

Mode function — Generate a single interrupt and an output pulse 
on PB7 for each Timer 1 load operation. Note: ensure that the Data 
Direction Register is set to allow PB7 to function as an output before 
using this nnode. 

POKE 37147, PEEK(37147) AND 63 OR 128 

ACR6 = '1' ACR7 = '1' 

Mode function — Generate continuous interrupts and pulses on 
PB7, the spacing between interrupts and pulses being deternnined by 
the contents of Tinner 1. Note: ensure that the Data Direction Register 
is set to allow PB7 to function as an output before using this nnode. 

POKE 37147, PEEK(37147)AND63 0R 192 

The one-shot nnode allows the generation of a single interrupt for 
each tinner load operation. The sequence of events is that the timer is 
loaded with a value, the counter then decrements this value, when 
zero is reached an interrupt is generated. The delay between the write 
operation and the generation of the interrupt is thus directly 
proportional to the data loaded into the counter. If the operating 
mode and Data Direction Register contents allow the generation of a 
pulse on peripheral line PB7 then the pulse width is also dependent on 
the value loaded into the counter. To use the timer in the one-shot 
mode the following sequence of operations are performed: 

1 — Set bits 6 and 7 of the Auxilian/ Control Register to give the 
correct operating mode — one-shot with output on PB7 and without 
output on PB7. If a pulse is to be output on PB7 ensure that the Data 
Direction Register is correctly set to define PB7 as an output. 
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2 — Load the low order latch (location $9116 of VIA No. 1) with low 
order part of value to be loaded into the counter. 

3 — Load the high order counter (location $9115 of VIA NO. 1) with 
the high order part of the timing value. 

Operation nunnber 3 initiates the following events: 

1 — The contents of the low order latch are transferred into the low 
order counter 

2 — If the PB7 output is enabled then this line will be pulled low on 
the phase two clock pulse following the write to high order counter. 

3 — The contents of the counter is decremented at the 02 system 
clock rate. 

4 — When the counter reaches zero the Timer 1 interrupt flag is set 
and a system interrupt generated (assuming the interrupt is enabled), 
if the output on PB7 is enabled then that line will go high. 

5 — The counter will roll over and continue decrementing from a 
value of decimal 65,535. This allows the system processor to read the 
counter contents and determine the time since the interrupt. The 
Timer 1 interrupt flag will not be reset until it has been cleared by a 
read of low order counter or a write to high order latch). 

Note: when using the timers, the count value loaded into the timer 
must be two counts less than the desired interval time, this is due to 
the 1 1 /2 cycle overhead on interval timing. 

The free-running mode allows the generation of a continuous series 
of evenly spaced interrupts. If the operation mode and Data Direction 
Register contents allow the generation of an output on peripheral line 
PB7 then a continuous series of pulses are also produced on this line. 
The time between each interrupt or output pulse is dependent on the 
contents of the Timer 1 latch bytes. To use the timer in the free- 
running mode the following sequence of operations are performed: 

1 — Set bits 6 and 7 of the Auxilian/ Control Register to give the 
correct operating mode — free-running with output on PB7 and 
without output on PB7. If pulses are to be output on PB7 ensure that 
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the Data Direction Register is correctly set to define PB7 as an output. 

2 — Load the low order latch (location $91 16 of VIA No. 1) with the 
least significant byte of the counter delay value). 

3 - Load the high order latch (location $9115 of VIA No. 1) with the 
most significant part of the counter delay value. 

This will initiate the following sequence of events: 

1 — The counter of Timer 1 will be loaded with the contents of the 
two latch registers. 

2 — The counter will start decrementing at the (f)2 system clock 
rate. 

3 — When the counter reaches zero the interrupt flag will be set 
and if Timer 1 interrupts are enabled a system interrupt will be 
generated. The output on line PB7 will be inverted (it will go low on 
the first interval) if outputs on this line are enabled. 

4 — The latch contents will be reloaded into the counter and the 
process repeated through from step 1 to 4 until disabled by changing 
the operating mode. 

Timer 2 occupies two registers of the 6522, one contains the low 
order latch and counter value, the second contains the high order 
counter, together they comprise a single sixteen bit counter. The 
location of these two registers, number 9 and 10, in the VIC are as 
follows: 

Register 9 — Timer 2 low order latch/counter 

VIA No. 1. — Hex $91 18 decimal 37144 
VIA No. 2. — Hex $9128 decimal 371 60 

Register 1 — Timer 2 high order counter 

VIA No. 1 — Hex $91 19 decimal 37145 
VIA No. 2 — Hex $9129 decimal 37161 

The operation of register 9 is a 'write only' latch and a 'read only' 
counter which contains the least significant byte of the the counter 
value. The functions of the two registers are summarised in the 
following commands to the registers of Timer 2 of VIA No. 1 . 
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POKE 37144, 255 :put 255 into the low order latch 

A = PEEK (37144) :variable A will contain the value in the low 

order counter. This will clear the Tinner 2 

interrupt flag. 

POKE 37145, 255 :put255 into the high order counter and transfer 
the contents of the low order latch to the low 
order counter. Will clear the Tinner 2 interrupt 
flag. 

A = PEEK(37145) A = contents of high order counter 

Tinner 2 has two nnodes of operation, these nnodes are selected by 
the contents of bit 5 of the Auxilian/ Control Register. In the first mode 
Tinner 2 acts as an internal timer (in the one-shot mode only) and in the 
second mode as a counter of pulses input on peripheral line PB6. The 
ACR contents controlling these two modes are as follows: 

ACR bit 5 — '0' = one-shot interval timer 
'1 ' = pulse counting mode 

The mode can be set with the following Basic commands: 

ACR5 - '0' POKE 37147, PEEK(37147)AND223 

ACR5 = 'V POKE 37147, PEEK(37147) AND 223 OR 32 

The operation of Timer 2 in the one-shot interval timer mode is 
similar to the same mode on Timer 1 allowing the generation of a 
single interrupt for each timer load operation. The delay between the 
write operation and the interrupt is proportional to the value stored in 
the two counter registers, this value being decremented at the 02 
system clock rate. When the value reaches zero the interrupt is 
generated. To use the timer in this mode the following sequence of 
operations is performed: 

1 - Set bit 5 of the ACR to logic '0' to give the correct operating 
mode. 

2 — Write the least significant byte of the interval count value into 
the low order latch (location $91 1 8 of VIA No. 1 ). 
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3 — Write the most significant byte of the interval count value into 
the high order counter (location $911 9 of VIA No. 1 ). 

Operation 3 initiates the following events; 

1 — The contents of the low order latch are transferred into the low 
order counter. 

2 — The contents of the counter have decrennented at the 02 systenn 
clock rate. 

3 — When the counter reaches zero the Tinner 2 interrupt flag is set 
and if the interrupt is enabled a system interrupt generated. 

4 — The counter will roll over and continue to decrement from a 
value of decimal 65,535. This allows the system processor to 
determine the time since the interrupt. The Timer 2 interrupt flag will 
not be reset until it is cleared by reading the contents of the low order 
latch or writing to the high order counter. The latter will also initiate a 
new interval timing sequence. 

In the pulse counting mode the function of Timer 2 is to count a 
predetermined number of negative going pulses input on peripheral 
line PB6, the counter can also be used as a straight pulse counter. The 
two registers of Timer 2 are loaded with a value. Writing into the high 
order byte initiates the countdown and clears the interrupt flag. The 
counter contents are decremented each time a pulse is applied to line 
PB6. When the counter reaches zero the interrupt flag is set. To use 
Timer 2 in the pulse counting mode requires the following sequence 
of operations: 

1 — Set bit 5 of the ACR to logic '1' to give the correct operating 
mode. 

2 — Set the Data Direction Register so that line PB6 is an input, 
this can be done with the following command (the register location is 
for VIA No. 1). 

POKE37138, PEEK(37138)AND191 

3 — Load the low order latch (location $9118 of VIA No. 1) with the 
least significant byte of pulse count value. 
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4 — Load the high order counter (location $9119 of VIA No. 1) with 
the nnost significant byte of the pulse count value. 

Operation 4 initiates the following sequence of events: 

1 — The contents of the low order latch is transferred into the low 
order counter and the interrupt flag is cleared. 

2 — The counter contents are decrennented on a negative going 
pulse. This pulse nnust have gone low prior to the leading edge of the 
02 clock pulse, if not then the counter will not be decrennented until 
the next 02 clock pulse. 

3 — The counter continues to be decrennented by pulses input on 
PB6 until the counter reaches zero. On reaching zero the interrupt flag 
is set. 

4 — The counter will roll over and contain the value decinnal 
65,535, further pulses input on PB6 will continue to decrennent this 
value. However, it will be necessan/ to rewrite the contents of the 
high order counter or read the low order counter to reset the interrupt 
flag. 

Tinner 2 is also used to control the frequency of input or output fronn 
the internal shift register of the 6522. 

Both the internal tinners on the 6522 have several features in 
connnnon, the principle being that they are all 'retriggerable'. This 
nneans that the tinne-out period will always be re-initialised by 
rewriting the counter. The value of this is that a tinne-out and its 
associated interrupt can be prevented if the processor rewntes the 
tinner prior to its reaching zero. This is utilised by all the tinne-out 
features of the I/O software on the VIC, thus allowing proper 
detection of tinne-out errors. The second innportant feature is that 
both counters have a 1 1/2 clock cycle 'overhead' on the tinne interval. 
This nneans that the count value loaded into the tinner nnust have a 
value, two counts less, than the required intenyal. 
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THE SHIFT REGISTER 

One of the internal registers of the 6522, register 11, functions as a 
shift register, converting data between serial and parallel format. 
Eight data lines, one control line and a ground line, are required to 
transfer a byte of data from a peripheral I/O port like a VIA to an 
external device. With serial transmission this same byte of data can be 
transferred using just three lines, a data line, a control line and a 
ground line. Serial data transmission is thus of considerable use in 
controlling and communicating with external devices, where the 
number of lines connecting the computer to the external device must 
be kept to a minimum. The internal shift register of the 6522 allows 
this serial input/output of data, though its functioning and flexibility 
is less sophisticated than a standard DART (Universal Asynchronous 
Receiver Transmitter). Besides generating or inputting serial data, the 
shift register can perform a range of other functions, including 
variable frequency pulses output on one of the VIA I/O lines and a 
means of expanding the I/O capability of the VIA. 

Two I/O lines are associated with the operation of the shift register, 
they are CB1 and CB2. The CB2 line is used for the serial transmission of 
the byte of data either into or out of the shift register. CB1 is used to 
carry the internally or externally generated shift clock pulses which 
clock the serial data in or out of the shift register. Each pulse on the 
shift clock shifts the entire contents of the shift register one bit to the 
left, bit 7 being output on line CB2 or the current logical state of the 
CB2 line input into bit 0. The contents of the shift register can be read 
or data loaded into it, by the standard processor read or write 
commands. There are three sources of the shift clock each having a 
different function and application, they are: 

1 — Timer 2 low order register. The bottom eight bits of the 16 bit 
Timer 2 counter are used to create a programmable rate shift clock. The 
value loaded into the least significant byte of the timer controls the 
time between transitions of the shift clock, two transitions are 
required for one complete shift clock cycle. The value loaded into the 
timer can be between and 255 and the timer count down rate is 
determined by the frequency of the processor ^2 clock, in the VIC this 
is MHz 1.1082. A delay time between transitions of 4.433 to 571.831 
microseconds can be programmed between each shift operation. The 
shift clock pulses generated by Timer 2 are output on line CB1 . 
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2 — Microprocessor (/)2 clock. The processor clock can be 
programmed to directly provide the shift clock pulses. The ^2 clock 
signal is divided by two, this gives a maximum shift clock on the VIC of 
KHz 554.1 which gives a delay between each shift of 1.8 
microseconds. 

3 — An external signal applied to the CBl line. This square wave 
signal input on CBl can be any frequency subject only to a maximum 
of KHz 554.1. 

The shift clock pulses are counted by a modulo-8 counter. When this 
counter has counted eight shift pulses it sets the shift register flag in 
the interrupt flag register. When the processor reads or writes data to 
the shift register the shift register flag is cleared. By clearing the shift 
register flag the modulo-8 counter is set to zero, the shift clock 
enabled, and data shifted in or out of the shift register. After eight shift 
pulses the flag is set and the shift clock disabled. In some modes of 
operation the modulo-8 counter is re-triggered by a write command 
to the shift register during a shift operation. In the free-running mode 
the modulo-8 counter is not used, resulting in continuous repeated 
output of the contents of the shift register. 

The shift register of the 6522 has eight modes of operation and the 
mode used is selected by setting bits 2, 3 and 4 of the Auxilian/ Control 
Register. The eight operating modes can be divided into four output 
modes and four input modes, for VIA No.l., the modes and 
commands are: 

ACR2 = '0' ACR3 = '0' ACR4 - ^0' 

Mode function — The shift register is disabled. 

POKE 37147, PEEK(37147) AND 227 

ACR2 = 'l' ACR3 = '0' ACR4 = '0' 

Mode function — Input data on line CB2 and put into bit of shift 
register, under control of Timer 2 low order counter, shift clock pulses 
output on CBl. Note: does not appear to work properly under Basic 
commands. 

POKE 37147, PEEK(37147) AND 227 OR 4 
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ACR2 = '0' ACR3 = '1' ACR4 = '0' 

Mode function — Input data on line CB2 under control of the system 
(t)2 clock and put into bit of shift register, shift clock pulses output on 
CB1 . Note: does not appear to work properly under Basic connnnands. 

POKE 37147, PEEK(37147) AND 227 OR 8 

ACR2='r ACR3-'l' ACR4 = '0' 

Mode function — Free running output of the shift register contents 
under control of Tinner 2. In this mode the contents of the shift register 
are recirculated, bit 7 of the shift register is shifted onto the CB2 output 
line and simultaneously shifted into bit of the shift register. The 
frequency of the shift pulses is determined by the contents of the low 
order byte of Timer 2. The result is the continuous repeated output of 
the contents of the shift register. In this mode the CB2 line can be used 
as a programmable frequency source or a simple music generator (by 
connecting CB2 to an amplifier and speaker). 

POKE 37147, PEEK(37147) AND 227 OR 16 

ACR2 = '1 ' ACR3 - '0' ACR4 = '1 ' 

Mode function — Output data from shift register on line CB2 under 
control of Timer 2. The time delay between shift pulses is determined 
by the contents of the low order byte of Timier 2. A PEEK com.m.and to 
the shift register will reset the shift register flag in this mode even 
though the shift process is not completed. 

POKE 37147, PEEK(37147) AND 227 OR 20 

ACR2 = '0' ACR3 = '1' ACR4 = '1' 

Mode function — Output data from shift register on line CB2 under 
control of the system 02 clock. 

POKE 37147, PEEK(37147) AND 227 OR 24 

ACR2 = 'V ACR3 = '1' ACR4 = '1' 
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Mode function — Output data fronn shift register on line CB2 under 
control of an external shift clock input on line CB1 . 

POKE 37147, PEEK(37147) AND 227 OR 28 
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INTERRUPTS 

The 6522 VIA has only a single interrupt request line to the 6502 
nnicroprocessor, VIA No. 1., interrupt is connected to the processor 
NMI interrupt and VIA No. 2., is connected to the IRQ interrupt. The 
interrupt output from the VIA can be activated (pulled to a logic '0' 
level) by any one of seven different conditions. These conditions are 
represented by bits in the Interrupt Flag Register (IFR), each bit or 
'flag' can be set to either logic '1', the 'on' state, or to logic '0' the 'off 
state. These flags are set as a result of certain conditions arising fronn 
the use of the other registers of the VIA. However, for one of these 
flags to activate the IRQ line to the processor requires two things to be 



1 — The bit in the IFR that represents the condition which 
generates the interrupts nnust be 'on' and thus set to logic '1 '. 

2 — The corresponding bit in the Interrupt Enable Register (lER) 
nnust also be set to a logic '1 '. 

Without the correct bits in the lER being set an interrupt condition 
will only set a flag in the IFR and will not generate a processor 
interrupt. These two registers, the Interrupt Flag Register and the 
Interrupt Enable Register are thus directly connected in their function. 
The location of these two registers, number 14 and 15 in the VIC are as 
follows: 

Register 14 — Interrupt flag register 

VIA No. 1 — Hex $91 1 D decimal 371 49 
VIA No. 2 — Hex $91 2D decimal 371 65 



7 6 5 4 3 2 10 
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CA2 interrupts flag 
CA1 interrupt flag 
Shift Register interrupt flag 
CB2 interrupt flag 
CB1 interrupt flag 
Timer 2 interrupt flag 
Timer 1 interrupt flag 
IRQ has occurred 
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Register 1 5 — Interrupt enable register 

VIA No. 1 — Hex $91 1 E decimal 371 50 
VIA No. 2 — Hex $91 2E decimal 37 1 66 

7 6 5 4 3 2 10 

I — CA2 interrupt enable 

CAl interrupt enable 

Shift register interrupt enable 

CB2 interrupt enable 

CBl interrupt enable 

Timer 2 interrupt enable 

Timer 1 interrupt enable 

lER set/clear control 

Each flag in the Interrupt Flag Register is set or cleared by a specific 
operation to one or more of the other registers of the 6522, this is 
summarised in the following table: 



BIT SET BY 

Active transition on CA2 

1 Active transition on CAl 

2 Completion of 8 shifts 

3 Active transition on CB2 

4 Active transition on CBl 

5 Timeout on Timer 2 

6 Timeout of Timer 1 



7 Any IFR bit with 

corresponding lER bit 
also set 



CLEARED BY 
Reading or writing Output 

Register A 
Reading or writing Output 

Register A 
Reading or writing to 

Shift Register 
Reading or writing Output 

Register B 
Reading or writing Output 

Register B 
Reading Timer 2 counter 

low byte or writing 

Timer 2 high byte 
Reading Timer 1 counter 

low byte or writing 

Timer 1 high byte 
Writing logic '0' to the 

appropriate bit in IFR 
orlER 



Bit 7 of the Interrupt Flag Register is connected to the IRQ output 
line of the VIA , and is set to logic '^' when one of the other seven 
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lower order bits in the IFR is set, it thus signals the condition that an 
interrupt has occured. Bit 7 of the Interrupt Enable Register is used to 
control the contents of the other seven lower order bits. If bit 7 of the 
lER IS set to logic '^' then all other bits in that register which are set to 
logic '1' will enable the interrupt request corresponding to that bit. 
Thus the Timer 1 interrupt to the processor would only be enabled if 
bits 7 and 6 are both set to logic '1'. If bit 7 of the lER is set to logic '0' 
then any of the seven lower order bits of the lER which are set to logic 
'1' will disable the interrupt request corresponding to that bit. Thus all 
processor interrupts from a VIA could be disabled by setting bit 7 of 
the lEP to '0' and all other seven bits to 'V. Initialising the lER takes 
two write operations, one to select the enabled interrupt conditions 
and the other to select the disabled conditions. It should be noted that 
bit 7 of the lER 13 only active during a Write operation, when the 
contents are read it will always contain a logic '^' irrespective of its 
actual contents. The enabling or disabling of interrupts using the lER 
does not affect the setting of interrupt flags in the IFR. 

The NMI interrupt is connected to the IRQ output of VIA No. 1., and 
the IRQ interrupt is connected to the IRQ output of VIA No. 2. When 
one or other of these interrupt lines is pulled low by an interrupt from 
one of the VIA's, the processor completes the current instruction 
pushes the register contents and program counter onto the stack and 
jumps to either the NMI of IRQ interrupt handling routines. The 
starting addresses of the two interrupt handling routines are stored in 
the top few bytes of memon/. The NMI start address is located at 
$FFFA and $FFFB and the IRQ start address at $FFFE and $FFFF. In the 
VIC the start addresses of the interrupt handling routines point to two 
jump addresses located in RAM, the RAM jump vectors, IRQ at $0314 
and $0315 and NMI at $0318 and $0319. These RAM vectors contain 
the actual start address of the interrupt handling routine. The reason 
for using the RAM vectors is that it allows the programmer to change 
the starting address of the interrupt handling routines, thus creating 
his own interrupt handling routines. 

Since there are as many as seven different conditions in the VIA 
which can generate an interrupt request to the processor, a single VIA 
might require as many as seven interrupt service routines. The VIC, 
with two VIA chips connected to each of the two interrupt request 
inputs of the 6502, has a potential requirement for up to fourteen 
interrupt service routines in the system software (in practice only 6 
are used). To determine which one of the seven interrupt conditions 
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of the VIA caused the interrupt request, a programming technique 
known as polling is used. The interrupt handling routines show how 
this is done by the VIC. 
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FUNCTION CONTROL 

Control of the various functions and operating modes within the 
6522 is accomplished primarily through two registers, the Peripheral 
Control Register (PCR) and the Auxiliary Control Register (ACR). The 
PCR is used to select the operating modes of the four peripheral I/O 
control lines. The ACR selects the operating mode of the two timers 
and the shift register. 

Peripheral Control Register (PCR). 

The organisation and location of the Peripheral Control Register is 
as follows: 

Register 13 — Peripheral Control Register 

VIA No. 1 —Hex $91 10 decimal 37148 
VIA No. 2 — Hex $91 20 decimal 371 64 



Bit No. 

Function 



The PCR has four seperate function fields, each associated with one 
of the four I/O port peripheral control or 'handshake' lines. 

CAl Control — Bit of the PCR selects the active transition of an 
input on the CAl line. If bit of the PCR is set to logic '0', then the CAl 
interrupt flag will be set by a negative transition on the CAl line (the 
line goes from a logic high to a logic low voltage level). If PCRO is set to 
logic '^' then the CAl interrupt flag is set by a positive transition (low 
to high). 

CA2 Control — Bits 1, 2 and 3 of the PCR. The CA2 line can act as 
either an interrupt input or a peripheral control output, there are 
altogether eight different operating modes for this line, they are 
summarised in the following table: 
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Control 
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Control 


1 1 

CA2 Control 


CAl 
Control 



PCR3 PCR2 PCRl 



Mode 



Input Mode, set CA2 interrrupt flag on a 
negative transition of the input signal. 
Clear IFRO on a read or write of the 
Penpheral A Output Register. 
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1 Independent interrupt input mode, set IFRO on 

a negative transition of CA2 input signal. 

Reading or writing ORA does not clear the 
CA2 interrupt flag, can only be cleared by 
writing '1 ' to the appropriate IFR bit. 

1 Input Mode. Set CA2 interrupt flag on a 

positive transition of the CA2 input line. 
Clear IFRO with a read or write of the 
Peripheral A Output Register. 

1 1 Independent interrupt input nnode. Set 

IFRO on a positive transition of CA2 input 
signal. Reading or writing ORA does not 
clear the CA2 interrupt flag, can only be 
cleared by writing '1 ' to the appropriate 
IFR bit. 

1 Handshake output nnode. Set CA2 output 

low on a read or write of the Peripheral 
A Output Register. Reset CA2 high with 
an active transition on CA1 . 

1 1 Pulse output mode. CA2 goes low for one 

processor clock cycle following a read or 
write of the Peripheral A Output Register. 

1 1 Manual output mode. The CA2 output is 

held 'low' in this mode. 

1 1 1 Manual output mode. The CA2 output is 

held 'high' in this mode. 

CB1 Control — Bit 4 of the PCR controls the active transition of the CB1 
input line in the same manner as that described for the CA1 line. In 
addition if the Shift Register has been enabled line CB1 will act as an 
output for the shift register clock pulses. In this mode the CB1 
interrupt flag will still respond to the selected transition of the signal 
on the CB1 line. 
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CB2 Control — When the serial I/O capability of the shift register is 
disabled then the function of the CB2 line is controlled by bits 5, 6 and 
7 of the PCR. There are altogether eight different operating modes for 
this line and they are summansed in the following table: 

PCR PCR6 PCR5 Mode 

Interrupt input nnode. Set CB2 interrupt 

flag (IFR3) on a negative transition of the 
CB2 input line. Clear IFR3 on a read or 
wnte of Peripheral B Output Register. 

1 Independent interrupt input nnode. Set 

IFR3 on a negative transition of the CB2 
input line. Reading or writing ORB does 
not clear the CB2 interrupt flag, clear 
by setting IFRSto'V. 

1 Input nnode. Set CB2 interrupt flag on a 

positive transition of the CB2 input line 
Clear the CB2 interrupt flag on a read or 
wnte of ORB. 

1 1 Independent input mode. Set IFR3 on a 

positive transition of the CB2 input line 
Reading or writing ORB does not clear CB2 
interrupt flag, clear by setting IFR3 to logic '1 '. 

1 Handshake output mode. Set CB2 low on a 

write ORB operation. Reset CB2 high with 
an active transition of the CBl input. 

1 1 Pulse output mode, set CB2 low for one 

processor clock cycle following a write 
ORB operation. 

1 1 Manual output mode. The CB2 output IS 

held 'low' in this mode. 

1 1 1 Manual output mode. The CB2 output is 

held 'high' in this mode. 
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is as 



Auxilian/ Control Register (ACR). 

The organisation and location of the Auxiliary Control Register 
follows: 

Register 1 2 — Auxiliary Control Register 

VIA No. 1 — Hex $91 1 B decimal 37147 
VIA No. 2 — Hex $91 2B decimal 371 63 



Bit No. 



Function 



The ACR controls the operation of six of the 6522 registers, the way in 
which it controls them is explained in detail in the sections covenng those 
registers. 
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188 - The Cassette Unit 

197 - Vic Keyboard 

204 - RS232 Serial Communications 

216 - Joysticl<s 

221 — Memory Expansion Connector 

224 - SenallEEE Port 
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TYPE 
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CASSETTE MOTOR 
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CASSETTE READ 
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CASSETTE SWITCH 



Fig. 25 — The allocation and function of pins on the Cassette connector. 
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Fig. 26 — The cassette circuit and its connection to the 6522 chips. 



THE CASSETTE UNIT. 

The Cassette Hardware. 

The VIC has a single external cassette unit which is used for 
progrann and data storage. The cassette deck is connected to the VIC 
by six lines — Write, Read, Motor, Sense, and two power lines, around 
and +5 volts. The connections are shown in Figure. 25. The cassette is 
controlled by I/O lines from the two VIA chips and the source of each 
of the cassette control lines fronn the VIAs is shown in Figure 26. The 
cassette nnotor power supply lines are connected to the interface 
chips via a three transistor driver used to boost the power and 
voltage, allowing the nnotor to be dnven directly. The output to the 
nnotor is an unregulated -1-9 volts at a power rating of up to 500nna. 
The cassette deck motor can be turned on and off by toggling the CA2 
line on 6522 No. 1.: 

POKE 37148, PEEK(37148) AND 241 OR 14 turns the motor on 
POKE 37148, PEEK(37148) OR 12 AND NOT 2 turns it off 

The sense line input, line PA6 on VIA No. 1., is connected to a switch 
on the cassette deck which senses when either the Play, Rewind or 
Fast Forward buttons have been pressed. The switch is only required 
to sense the pushing of the Play button during a read or write to tape 
routine, this is done by a subroutine at $F8AB. If either the rewind or 
fast forward button is pressed accidently instead of the play button 
the system will be unable to tell the difference and will act as if the 
play button was pressed. For a similar reason during a record routine 
the record button must be pressed before the play button since 
recording will start as soon as the sense switch is closed by pressing 
the play button. 

The cassette "Read" line is connected to the CA1 line of VIA No. 2., 
and the cassette "Write" line to line PB3 of VIA No. 2. During a Read 
operation the operating system uses the setting of the CA1 interrupt 
flag to detect transitions on the cassette Read line. The functioning of 
the Read and Write lines is controlled entirely by the operating 
system, the only hardware required being signal amplification and 
pulse shaping circuitn/. These circuits are contained on a small PC 
board within the cassette deck, their function being to give correct 
voltage and current to the record head and amplify the input from the 
read head to give a 5 volt square wave output able to produce an 
interrupt on the CA1 orCBI lines. 
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The Cassette Operation. 

In nornnal usage the cassette deck is assigned an I/O device 
number, the cassette is device nunnber 1, the device nunnber of the 
device currently being used is stored in location 186. The device 
nunnber, the logical file nunnber and the secondan/ address are used 
when saving or retrieving data files fronn the cassette deck. The 
logical file nunnber can be any nunnber fronn 1 to 255 and is used to 
allow nnultiple files to be kept on the sanne device, it is of little use with 
cassette tape and primarily intended for use with floppy disk units. It 
is usual to have the logical file number the same as the device number, 
the logical file number of the current file is stored in location 184. The 
secondan/ address is important since it determines the operational 
mode of the cassette, the current secondan/ address is stored in 
location 185 the normal default value being zero. If the secondan/ 
address is zero then the tape is Opened for a "read" operation, if set to 
1 then it is opened for a "write" operation and if 2 then it is opened for 
a "write" with an end of tape header being forced when the file is 
closed. 

The VIC operating system is configured to allow two different types 
of file to be stored on cassette: program files and data files. These 
names are however rather misleading since a program can be stored 
as a data file and data can be stored as a program file. The difference 
between these two file types is not in their application but in the way 
the contents of the machine's memory is recorded. Instead of 
program and data files we must look upon them as Binan/ and ASCII 
files. 

A binan/ file is usually used to store programs, since a binan/ file is 
created by the operating system to store the contents of memon/ 
between a starting location and an end location. Called a binan/ file 
because it stores on tape the binan/ value in each memon/ location 
within the assigned memory area. Basic statements are stored in 
memon/ using tokens. The use of tokens means that Basic commands 
are not stored in the same manner as they are listed on the display or 
were entered on the keyboard. They are instead stored in memon/ in a 
partly encoded form. Being partly encoded, a binar/ file is a quicker 
and more efficient way of stonng programs. Binan/ files are essential 
when saving and loading machine code programs. 

The starting address from which a binan/ file will be saved is stored 
in locations 172 and 173. These locations are loaded by the Save 
routine with memon/ location at which the 'save' will begin, normally 
they will be set to and 4 thereby pointing to the start of the Basic text 

189 



256ijs 



176^js 



176 JUS 



0' 



256his 



256l 





176>js 




256>is 



336>ir 



256>js 





336>js 




256ps 



Fig. 27 — The output waveforms to the cassette recorder. 
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area at 1024. They can be altered by the 'save' routir^e to poir^t to any 
location in nnennon/. The end address of the area of nnennon/ to be 
saved is stored in locations 174 and 175. Nornnally when saving a Basic 
progrann these are set to the address of the double zero byte 
ternninating link address. The end address can be altered to any 
desired location. To change either of these addresses one can not use 
the nornnal save routine since this autonnatically initialises these 
locations. Instead one nnust write a snnall nnachine code initialisation 
routine incorporating the desired operating systenn subroutines. By 
default a Save connnnand will write a binan/ file and a Load connnnand 
will read a binan/ file. 

ASCII files are normally used to store data, (but can be used to store 
proganns, see Merge procedure) and the fornnat is the sanne as that 
displayed on the screen or entered on the keyboard. ASCII files are 
created or read ainnost exclusively by instructions fronn within a Basic 
progrann. A binan/ file is created or read nnostly by direct instructions, 
although the LOAD and SAVE instructions can be used within a 
progrann. 

An ASCII file nnust first be opened with an OPEN statennent, this 
specifies the logical file, device nunnber, secondan/ address and file 
nanne. The operating systenn interprets these paranneters and allows 
the user to read or write the file to the specified device. Data is written 
to an ASCII file on a particular device with a connnnand to PRINT to the 
specified logical file nunnber, and data is read by a READ fronn logical 
file connnnand. 

Whereas a binan/ file is loaded with the contents of successive 
nnennory locations, an ASCII file is loaded with a string of variables. 
Storing these would require the tape to be turned on and off 
repeatedly, storing a few bytes of data at a tinne. The VIC overconnes 
this by having a 192 byte tape buffer into which all data to be written 
"to", or read "fronn" tape is loaded. Only when this buffer is full is the 
tape nnotor turned on. Data is stored on tape in blocks of 192 bytes and 
since the nnotor is turned on and off between blocks a two second 
interval is left between blocks to allow the nnotor to accelerate and 
decelerate. The beginning of the 192 character buffer starts at address 
828. The pointer to the start of the buffer is located at address 178 and 
179. The nunnber of characters in a buffer is stored in locations 166. 
These locations can be used by the progrannnner to control the 
annount of space left in a data file. If having opened a file on cassette, 
the connnnand POKE 166,191 is executed then the contents of the tape 
buffer even if ennpty are loaded onto the tape. If records are kept in 
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multiples of 191 bytes we can very easily keep nul or partially filled 
records allowing future data expansion. 

Whether the file being stored is binan/ or ASCII the recording 
method is the same involving an encoding method unique to 
Commodore and designed to ensure maximum reliability of recording 
and playback. Each byte of data or program is encoded by the 
operating system using pulses of three distinct audio frequencies, 
these are long pulses with a frequency of 1488Hz, medium pulses at 
1953Hz and short pulses at 2840Hz. All these pulses are square waves 
with a mark space ratio of 1:1, one cycle of a medium frequency is 256 
microseconds in the high state and 256 microseconds in the low state. 
The operating system takes about 9 milliseconds to record a byte of 
data consisting of the eight data bits, a word marker bit and an odd 
parity bit. The data bits are either ones or zeros and are encoded by a 
sequence of medium and short pulses: a "1" is one cycle of a medium 
length pulse followed by one cycle of a short length pulse and "0" is 
one cycle of a short length pulse followed by one cycle of a medium 
length pulse. Each bit consists of two square wave pulse cycles, one 
short and one medium with a total duration of 864 microseconds. The 
waveform timing is shown in the diagram in Figure 2 7. 

The 'odd parity' bit is required for error checking and is encoded like 
the eight data bits using a long and short pulse, its state is determined 
by the contents of the eight data bits. The 'word marker' separates 
each byte of data and also signals to the operating system the 
beginning of each byte. The word marker is encoded as one cycle of a 
long pulse followed by one cycle of a medium pulse, see Figure 27. 

Since a byte of data is recorded in just 8.96 milliseconds, a 192 byte 
block of data in an ASCII file should be recorded in just over 1.7 
seconds. However, on tim.ing such a recording we find it takes 5.7 
seconds. There are two causes for this discrepency in timing. Firstly to 
reduce the possibility of audio dropouts the data is recorded twice. 
Secondly a two second inter-record gap is left between each record of 
192 bytes. 

The extensive use of error checking techniques is one reason why 
the tape system on the VIC is so much better than that available on 
most other popular computers. There are two levels of error checking. 
The first divides the data into blocks of eight bytes and then computes 
a ninth byte, the checksum digit. The checksum is obtained by adding 
the eighth data bytes together, the checksum is the least significant 
byte of the result. On reading the tape if one bit in the eight bytes is 
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dropped and a zero becomes a one or vice versa the checksunn can be 
used to detect this error. To do this the sanne procedure to calculate 
the check digit is perfornned, the result will be different to that stored 
in byte nine, the check digit of that block computed when the tape 
was recorded. The second level of error checking involves recording 
each block of data twice. This allows errors detected by the check 
digit to be corrected during the second reading of the 192 byte data 
block. By recording the data twice a verification can be performed by 
comparing the contents of the two blocks, this will detect the few 
errors not detected by the checksum. 

The use of pulse sequence rather than two frequencies as in a 
standard FSK recording has a great advantage since it allows the 
operating system to easily compensate for variations in recording 
speed. Normally a hardware phase locked loop circuit would be used 
to lock the system onto the correct frequencies coming from the tape 
head, the VIC however uses software to perform this process. A ten 
second leader is written on the tape before recording of the data or 
program commences. This leader has two functions, first it allows the 
tape motor to reach the correct speed and secondly the sequence of 
short pulses written on the leader is used to synchronise the read 
routine timing to the timing on the tape. The operating system can 
thus produce a correction factor which allows a very wide variation in 
tape speed without affecting reading. The system timing used to 
perform both reading and writing is very accurate, based as it is on the 
crystal controlled system clock and Timer 1 and Timer 2 of VIA No. 2. 
Inter-record gaps are only used in ASCII files and their function is to 
allow the tape motor time to decelerate after being turned off and 
accelerate to the correct speed when turned on prior to a block read or 
write. Each inter-record gap is approximately two seconds long and is 
recorded as a sequence of short pulses in the same manner as the ten 
second leader. There is also a gap between blocks, when the first 
block of 192 bytes is recorded it is followed by a block end marker, 
which consists of one single long pulse followed by 50-h cycles of 
short pulses then the second recording of the 192 block starts, this is 
identical to the first block. 

The first record written on the tape after the ten second leader in 
both ASCII and binary files is a 192 character file header block. The file 
header contains the name of the file, the starting memory location, 
and the end location. In an ASCII file these addresses are the 
beginning and end of the tape buffer, in a binary file they point to the 
area of memory in which the program is to be stored. 
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The file name can be up to 128 bytes long, the length of the file name 
is stored in location 183, and when read is compared with the 
requested file name in the Load or Open command. If the name is the 
same then the operating system will read the file, if different then it 
will search for the next ten second interfile gap and another header 
block. The file name is stored during a read or write operation in a 
block of memon/, the starting address of which is stored locations 187 
and 188. On completion of the operation these are reset to point to a 
location in the operating system. The starting location is normally set 
to the beginning of the user memon/ area, address 1024, however it 
can be changed to point to any location, a method employed when 
recording programs in a machine code using the monitor, and also in 
the no copy program. The starting address is pointed to by the 
contents of locations 172 and 173, the end address being stored in 
locations 174 and 175. Normally this is the highest byte of memon/ 
occupied by the program, however it can be altered to point to any 
address providing it is greater than the start address. 

Important Memon/ Locations Used by the VIC Cassette. 

$92 — temp used to adjust software servo 

$93 — verify or load lag (0 = loading) 

$96 — flags if we have block sync (1 6 zero dipoles) 

$9B — holds currently calculated parity bit 

$90 — cassette dipole switch 

$9E — count of read locations in error pointer into $01 00 

$9F — count of re-read locations during pass No. 2. 

$A4 — used to indicate which half of dipole we are in 

$A5 — countdown for tape write; sync on tape header 

$A6 — cassette buffer pointer 

$A7 — tape short count 

$A8 — flags errors (if zero then no error) 

$A9 — counts zeros (if zero then correct No. of dipoles) 

$AA — bits 6 & 7 hold function mode, rest = sync countdown 

$AO-$AD — indirect address to start of tape data storage 

$AE-$AF — indirect address to end of tape data storage 

$B1 — holds dipole time during types calculations 

$B2-$B3 —start address of tape buffer 

$B4 — flags if we have a byte sync (a longlong) 

$B5 — used to preserve sync outside of bit routines 

$B6 — has combined error values from bit routines 

$B7 — length of current file name string 

$B8 — current logical file number 
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$B9 — current secondary address 

$BA — current device nunnber 

$BB-$BC — address of current file nanne string 

$BD — receive input character 

$BE — indicates which block we are looking at (0 to exit) 

$BF — holds input byte being built 

SCO — cassette nnanual/controlled switch 

$C3-$C4 — cassette load tennp storage 

$D7 — holds most recent dipole bit value 

$01 00-$01 FF — storage of bad read locations, bottonn of stack 

$0259-$0262 — logical file nunnber table 

$0263-$026C — device number table 

$026D-$0276— secondan/ address table 

$033C-$03FC— cassette buffer 

System subroutines used by the VIC cassette. 

$F542-$F646 — Load RAM routine. Loads from cassette or serial 
device as determined by contents of $BA. Verify flag in .A. Alternately 
load if $B9 = (normal $B9 - 1) .X, .Y contain load address if .A = 
performs load (0 is verify). 

High load address returned in .X and .Y. 

$F675-$F734 — Save RAM routine. Saves to cassette or serial device 
selected by contents of $BA. Start of save is indirect at .A, end of save 
IS .X, .Y. 

$F7AF-$F889 — Find tape header information, reads tape until one of 
the following block types is found: basic data file header, or basic load 
file. For success cam/ is clear on return. In addition accumulator is if 
stop key was pressed. 

$F88A-$F98E — Miscellaneous tape control routines. 
Includes: 

F8AB — cassette sense switch control 

$F8B7 — check for play and record 

$F8C0 — read header block entn/ 

$F8C9 — read load block entn/ 

$F8E3 — write header block entn/ 

$F8F4 — start tape operation entn/ point 

$F95D — set up timeout watch for next dipole 
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$F98E-$FABC — Cassette read routines. The character read is passed 
to the byte routine in location $BF. 

$FABD-$FBE9 — Byte handler for cassette read. The byte assembled 
fronn reading tape is passed to this routine in $BD. $A8 is set if byte 
read is in error and $A9 is set if the interrupt progrann is reading zeros. 
$AA tells us what we are doing, bit 7 says ignore bytes until $A9 is set 
and bit 6 says load the byte. Otherwise $AA is a countdown after sync. 
If $93 is set we do a compare instead of store and set status. $BE 
counts the two blocks, $9E is the index to the error table for pass No. 
1 ., and $9F is index to correction table for pass No. 2. 

$FBEA-$FD21 — Cassette wnte routines. Location $BE is the block 
counter for record. If $BE = 2 then first header 

= 1 first data 

= second data 

Note: The IRQ vectors are changed during cassette operation, if the 
user has reset these vectors then they should be restored to their 
normal value pnor to using the cassette. 
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THE VIC KEYBOARD 

The VIC keyboard has a total of 66 keys, this comprises 64 
alphanumeric and special function keys, the restore key and a shift 
lock key. The 64 alphanumeric and special function keys are 
connected as a simple matrix to the two eight line I/O ports of VIA No. 
2., the way they are connected is shown in Figure 29. The restore key 
connects the CA1 line of VIA No.1., to ground and is used to generate 
an NMI processor interrupt. The shift lock is simply a mechanical 
device for keeping the shift key depressed. The keyboard matrix is 
scanned for a key depression by having one eight line I/O port 
configured as outputs and the other as inputs. Each output line is 
connected via key switches to all eight of the input lines. If one of 
those eight keys is depressed then the voltage level on the output line 
will be transferred to the input line corresponding to that key. By 
having a scanning sequence where each of the eight output lines in 
turn go 'low' while the rest stay 'high' the operating system software 
can determine which key in the 64 key matrix is currently pressed. 

The scanning of the keyboard matrix and testing for depression of 
the restore key are all under software control. The entire processor 
time can not be devoted to keyboard scanning therefore scanning is 
initiated by a regular 1/60 second interrupt. Keyboard scanning is one 
of the functions of the IRQ interrupt servicing routine. The 1/60 
second regular interrupt is generated by Timer 1 of VIA No. 2. The 
interrupt service routine starts at location $EABF and the keyboard 
scanning portion at $EB1 E. 

The keyboard scanning routine goes through a sequence of 
operations the result of which is to place each input character into a 
special section of memon/, the keyboard buffer. The sequence is as 
follows: 

1 — check if key pressed, if not then exit from routine. 

2 — initialise I/O ports of VIA No. 2., for keyboard scan and set 
pointers into keyboard character table No. 1., set character counter to 
0. 

3 — set one line of port B low and test for character input on port A 
by performing eight right shifts of the contents of port A register, if 
cam/ is set then character present. Each shift increments character 
count, store character counter in .Y. 
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4 — go back to step 3 and repeat for next colunnn, if character found 
then continue. 

5 — use character count value as index pointer into keyboard 
character table to get ASCII code corresponding to depressed key. 

6 — see if it is a Shift or Stop key. 

7 — evaluate Shift function. 

if Shift key pressed then use character count to access 

keyboard character table No. 2. 
if CBM key pressed then use character count to access 

keyboard character table No. 3. 
if CBM and Shift pressed then use character count to 

access keyboard character table No. 4. 

8 — use character count value as index pointer into keyboard 
character table designated in step 7. 

9 — checkfor repeat key operation. 

10 — check for screen editor keys and take appropriate action. 

11 — do repeat if required. 

12 — put ASCII character obtained fronn the keyboard character 
tables into the keyboard buffer, incrennent the pointer into the 
keyboard buffer. 

The contents of the 10 character keyboard buffer are accessed on a 
first in first out basis by the screen handling routines. These routines 
take the first character in the keyboard buffer, decrennent the buffer 
pointer and close up the buffer by moving the contents down one byte 
thereby leaving space for new input characters. The exact function of 
the screen handling routines depends on the mode of operation of the 
VIC. If the VIC is in the Direct mode then the keyboard input is part of 
Basic routine to receive a program line from the keyboard, the starting 
address of this routine is $C560. If the VIC is running a Basic program 
then keyboard input is part of the Basic character string input routine, 
starting at location $CBBF. 

In the Direct mode, characters are removed from the keyboard 
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buffer and displayed or the screen, the character is also placed in the 
88 byte Basic input buffer. This continues until a carriage return key is 
pressed. The Basic interpreter then checks the contents of the Basic 
input buffer to determine if the input is a valid connmand, and if so 
then executes the command, if not returns a syntax error message. 

In the program mode, characters are removed from the keyboard 
queue when required by the Basic INPUT or GET commands during 
the running of a program. It is in this mode that the keyboard buffer is 
most useful, it allows a flexibility in timing between input from the 
scanning routine, and the execution by the Basic interpreter of the 
INPUT or GET command. This does have its drawbacks since any 
characters in the keyboard buffer prior to the execution of the input 
will be accepted as valid input characters. This can give rise to 
spurious data input and can be avoided by cleanng the keyboard 
queue pointer (location 649 is set to zero). 

One of the disadvantages of using the interrupt to initiate keyboard 
scanning is that the interrupt routines are changed during I/O 
operations between the processor and the cassette or serial I/O 
devices. The drawback is that the user looses control of the system if 
the keyboard is disabled as a result of a temporan/ sessation of 
scanning. The principle control key required is the Stop key, this 
allows the user to exit from an I/O 'hangup'. The solution to this 
problem is to leave the keyboard after each scan so that the column 
containing the Stop key is still being scanned, this means that output 
line PBS is left in an 'on' state. The I/O routines can then ven/ simply 
test for a depression of the Stop key by reading the input register of 
port A on VIA No. 2. The Stop key routine is thus separated from the 
rest of the keyboard scanning routines, the Stop key routine is in two 
sections: 

$F755 — this is part of the time function routine which is called in all 
IRQ servicing routines, it updates the real time clock and checks the 
Stop key. The contents of Port B of VIA No. 2., are read, debounced to 
make sure that the contents are stable and then stored in the Stop key 
flag — location $91. 

$F770 — this part of the routine is the main Stop key routine, it is 
called by an indirect address stored in the Stop key RAM vector at 
location $0328. This routine takes the contents of location $91 and 
compares it with the value $FE if equal then the Stop key has been 



201 



I REM *RULITINE TC 


} TEST WHICH FUNCTION 


2 REM *K:EV has BEEN PRESSED 


3 R'EM 


4 REM 


y REM *WHICH KEV PRESSEIr"' 


3 REM 


10 Fi==PEEK<2y3> 


11 REM 


12 REM *SH.IFT KEV DuWH''' 


14 REM 


15 E=PEEK;<653> 


16 REM 


1? REM :+:riECOriE KEV NUMBER 


18 REM 


20 K=0 


25 IFfl=39THE.NK=i 


GOT 050 


30 IFH=47THEHK=3 


GOTO50 


35 rFH=55THENK=5 


GOTO50 


40 IFfl=63THENK=^? 


GOTO50 


45 GOTO 10 


50 IFE31THENB-0 


55 K=K+B 





60 F'R I NT " FUNCT I ON KEV " K " F'RESSED " 
65 GOTO 10 



Fig. 30 — Program to use VIC function keys. 
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depressed. This initiates the clearing of the keyboard queue and I/O 
channels prior to returning to direct nnode operation. If the Stop key 
has not been pressed then control returns to the calling routine. 

$FEA9 — routine to handle an NMI interrupt, this is generated if the 
"Restore" key is pressed, the "restore" function is only initiated if the 
"Stop" key is also pressed. If both keys are pressed then a Basic warm 
start is initiated by a jump to $0002. 

Important memon/ locations used by the VIC keyboard. 

$91 — Stop key flag set if Stop key depressed 

$C5 — Key scan index 

$C6 — Index to keyboard queue 

$F5-$F6 — Indirect jump address to keys on table 

$0200-$0258 — Basic input buffer 

$0277-$0280 — Keyboard buffer 

$028A — Key repeat flag 

$028D —Shift flag 

028F-$0290 — Indirect jump address for keyboard table 

$0291 — VIC mode (CBM key pressed?) 

System subroutines used by keyboard, 

$C560 — routine to get Basic command from the keyboard and 
place in the Basic input buffer ready for the interpreter. 

$CBBF — routine performs the Basic character string input function. 

$E5CF — remove character from keyboard queue and return in .A 

$E64F — input line until carriage return key is pressed, part of Basic 
input routine. 

$E742 — displays character in .A on the screen at the current cursor 
location. 

$E800— handles shift keys 

$EABr — IRQ service routine 

$EB1E — general keyboard scan, uses keyboard character tables to 
obtain correct ASCII code for character and puts character into 
keyboard queue. 

$EBDC — shift key logic 

$EC5E — start of keyboard character table No. 1 . 

$EC9F — start of keyboard character table No. 2. 

$ECEO — start of keyboard character table No. 3. 

$ED72 — start of keyboard character table No. 4. 
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RS232 SERIAL COMMUNICATIONS 

The VIC is able to communicate with peripheral devices; printers, 
modems etc, using a serial communications port, known as an RS232 
I/O port. The name RS232 simply refers to an industn/ standard form 
of serial communication for computing devices. A senal I/O port can 
consist of as few as three lines, an output or transmit line, an input or 
receive line and a common ground line. The data is transmitted or 
received as a stream of pulses, a single byte becomes a stnng of eight 
pulses. 

Although a serial port can have just three lines, other lines are 
frequently used to transfer control information. The VIC is able to 
receive and generate such control signals to implement a full 'X line' 
interface as welt as the simple '3 line' interface. Whichever 
implementation is used all the lines are connected to I/O Port B of VIA 
No. 1., the same lines used for the user port. Normally an RS232 
interface card will be used to connect between the parallel port and a 
standard RS232 connector, the card will also provide buffering and a 
higher drive voltage. For communications using the simple 3 line 
mode an interface card can easily be constructed using a couple of 
buffer/driver ICs. The RS232 line normally transmits data using a 12 
volt signal, however, providing cables are kept short it will work with 
a 5 volt signal. The standard RS232 connector is shown in Figure 32, 
the function and pin assigment of each of these lines is as follows: 



VIA 


RS232 


; VIA 


Abv 


EIA 


In/ 


Modes 


Function 


line No, 


, pir 


iNo 


. pin No 






Out 






GND 


1 




A 


GND 


AA 





1,2 


Protective ground 


CB1 


3 




B 


SIN 


BB 


In 


1,2 


Received data 


PBO 


3 




C 


SIN 


BB 


In 


1,2 


Connected to SIN 


PB1 


4 




D 


RTS 


CA 


Out 


2 


Request to send 


PB2 


20 




E 


DTR 


CD 


Out 


2 


Data ternninal ready 


PBS 


18 




F 


Rl 


CE 


In 


3 


Ring indicator 


PB4 


8 




H 


DCD 


CF 


In 


2 


Received line signal 


PB6 


5 




K 


CTS 


CB 


In 


2 


Clear to send 


PB7 


6 




L 


DSR 


CC 


In 


2 


Data set ready 


CB2 


2 




M 


SOUTBA 


Out 


1,2 


Transmitted data 


GND 


7 




N 


GND 


AB 


— 


2,3 


Signal ground 


Modes: 


















1 — 3 - 


■line 


interface (note RTS and DTR are 


both held high during 


mode). 


















2 — X-line interface. 
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1 2 3 4 5 6 7 8 9 10 11 12 



A B C D E 



L M N 



Pi^ 


Typs 


N0T£ 


PIN 


TYPE 


RS232 FUNCTION 


] 

5 ' 




l0^rt>A WAX : 


B 

C 


:S:v:5(iwi:::;:;:S:: 
CBl 
PB0 


-1 SIN 


A 


:^C5[Y<} 




D 


PB1 


— RTS 


5 


JpYJ 




E 


PB2 


— DTP 


e 


JQv;' 




P 


PB3 


— Rl 


7 


LtGHT-PtN 




H 


PB4 


— DCD 


ft 
9 






::x>:j^:::::::x 


P86 


' '—' ' CTS 


: )^ 


6NQ 


ia0ovAWA.-X 


L 

M 
N 


PB7 
CB2 
GND 


— DSR 
_ SOUT 

— GND 



Fig. 31 — VIC RS-232 connector and pin allocations. 



014 
015 
OI6 
OI7 
OI8 
OI9 
O20 
02I 
022 
023 
024 
025 



lO 
20 
30 
40 
50 
60 
70 
80 
90 
10 O 
HO 
I20 
13 O 



PIN 








1 


Protective Ground 


AA 


2 


Transmitted Data 


BA 


3 


Received Data 


BB 


4 


Request To Send 


CA 


5 


Clear To Send 


CB 


6 


Data Set Ready 


CC 


7 


Signal Ground 


AB 


8 


Carrier Detect 


CF 


9 


(not used) 




10 








11 








12 








13 








14 








15 








16 








17 








18 








19 






20 


Data Terminal Ready 


CD 


21 


(not used) 




22 






23 






24 


" 




25 









Fig. 32 - Standard RS-232 connector and EIA line coding. 



205 



3 — User available only and not innplemented or used in the VIC RS232 
code. 

The innplennentation of the RS232 port on the VIC is ven/ interesting 
since it involves the use of software to ennulate a hardware device. 
The hardware is the 6551 Universal Asynchronous Transnnitter and 
Receiver or UART. It was originally intended by the VIC designers to 
use this chip to generate the RS232 I/O, however, MOS were unable 
to deliver usable devices in time for the VIC production, and software 
ennulation had to be employed. An exact emulation of the function of 
the 6551 is used since this allows the manufacturers to change the VIC 
hardware design to incorporate the 6551 as soon as this device 
becomes available. Like the other I/O chips the 6551 functions are 
controlled by registers at specific memon/ locations. The pseudo 6551 
registers are located in various parts of the variable storage area at 
the bottom of VIC memory. Besides the registers, the RS232 
operating routines require two 256 byte buffers, one for received data 
and the other for transmitted data. The 512 bytes of memon/ occupied 
by these buffers is located at the top of available RAM memon/, the 
starting address of the two buffers is stored in four register bytes. The 
two most important registers are the Control, and Command 
Registers, these determine the exact operation of the RS232 port, 
they can be summarised as follows: 

The 6551 Pseudo Control Register— Hex $0293 decimal 659 

The function of the Control register is to set the speed of data 
transmission and reception and set the number of bits needed to 
transmit each character. The speed at which data is input or output is 
called the baud rate, and the value assigned to this is the number of 
bits per second. If the baud rate is set to 300 baud, and each character 
is transmitted as the eight character bits plus one stop bit and one 
parity bit — total of ten bits — then 30 characters will be transmitted 
even/ second. The selected baud rate depends on the specifications of 
the device communicating with the VIC via the RS232 port, check the 
manual of the device before setting this value. Bits 5, 6 ana 7 control 
the number of bits needed to transmit or receive data between the 
VIC and a peripheral. The number of bits per character plus the 
number of stop bits depends on the device communicating with the 
VIC via the RS232 port. 

The 6551 Pseudo Command Register— Hex $0294 decimal 660 

The Command Register controls the mode of data transmission and 
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6 5 



STOP BITS -J 

0=1 STOP BIT 
1 -2 STOP BITS 



WORD LENGTH 



BIT 


DATA 

WORD LENGTH 


6 


5 








8 BITS 





1 


7 BITS 


1 





6 BITS 


1 


1 


5 BITS 



UNUSED BIT 



(Ml) Not implemented in the \/IC-20 system 



3 


2 1 









BAUD RATE 








USER RATE (Nl) 








1 50 BAUD 





1 


75 





1 


1 110 





1 


134.5 





1 


1 150 





1 1 


300 





1 1 


1 600 







1200 







1 1800 2400 




1 


2400 




1 


1 3600 (Nl) 




1 


4800 (Nl) 




1 


1 7200 (Nl) 




1 1 


9600 (Nl) 




1 1 


1 19200 (Nl) 



Fig. 33 - Function of bits in VIC RS-232 Control register. 
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reception. Bit sets the mode, a 3 line mode or a X line mode. Bit 4 sets 
the Duplex mode as follows: 

Full Duplex — simultaneous transmission and reception of data. 
Half Duplex — altemate transmission and reception of data. 

Bits 5, 6 and 7 determine the nature of the parity bit and whether the 
mark or space is transmitted. The parity bit is transmitted after the 
data bits and has an error checking function, the choice of whether the 
parity is disabled or is set to odd or even depends on the specification 
of the communicating device attached to the VIC RS232 port. The 
mark/space setting determines whether a logic 'V is transmitted as a 
zero voltage or a positive voltage, this is shown in Figure 4. 

The RS232 Status register— Hex $0297 decimal 663 

The other memory locations and pseudo 6551 registers are as 
follows: 

$A7 — receiver input bit temporary storage 

$A8 — receiver bit count in 

$A9 — receiver flag Start bit check 

$AA — receiver byte buffer/assembly location 

$AB — receiver parity bit storage 

$B4 — transmitter bit count out 

$B5 — transmitter next bit to be sent 

$B6 — transmitter byte buffer/disassembly location 

F7-$F8 — a two byte pointer to the receiver buffer base 

location 
$F9-$FA — a two byte pointer to the transmitter buffer base 

location 
$0298 — the number of bits to be sent/received 

$0299-$029A — the time for transmission of one bit cell based on 

system clock/baud rate 
$029B — the byte index to the end of the receiver FIFO buffer 

$029C — the byte index to the start of the receiver FIFO buffer 

$029D — the byte index to the start of the transmitter FIFO 

buffer 
$029E — the byte index to the end of the transmitter FIFO 

buffer 
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PARITY OPTIONS 



BIT 
7 


BIT 
6 


BIT 
5 


OPERATIONS 









Parity disabled, none 
Generated/Received 








1 


Odd Parity 
Receiver/Transmitter 





1 


1 


Even Parity 
Receiver/Transmitter 


1 





1 


Mark Transmitted 
Panty Check Disabled 


1 


1 


1 


Space Transmitted 
Parity Check Disabled 



DUPLEX 

0= FULL DUPLEX 
1 = HALF DUPLEX 



UNUSED 



HANDSHAKE 

0= 3 LINE 
1 = XLINE 



Fig. 34 — Function of bits in VIC RS-232 Command register. 
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RS232 System Routine Entry Points 

$EFA3 — entn/ for NMl continue routine 

$EFBF — calculate parity, $B5 = upon entn/ 

$EFE8 — count stop bits 

$EFEE — entn/ to start of byte transnnission 

$EFFB — set up to send next byte 

$F016 — set errors 

$F027 — calculate No. of bits to be sent, returns No. bits4-1 

$F036 — NMl routine to collect data into bytes 

$F040 — calculate parity 

$F046 —shift data bit in 

$F04B — have stop bit so store in buffer 

$F05B — enable to receive a byte 

$F068 — receiver start bit check 

$F06F — put data in buffer (at parity time) 

$F08B — parity checking 

$F094 — check calculated parity 

$F09F — errors reported 

$FOBC — output a file over user port using RS232 

$F0C4 —check for DSR and RTS 

$FOCD — check for active input, RTS will be low if currently 

inputting 

$F0D4 — wait for CTS to be off 

$F0D9 —turn on RTS 

$FOE 1 — wait for CTS to go on 

$FOED — buffer handler to output a character 

$FOFC — set up if necessary to output 

$F102 — set up for a first byte out 

$F10E — setupforTl NMI's 

$F1 1 6 — input a file over user port using RS232 

$F1 22 — check if DSR and not RTS 

$F1 2B — wait for active output to be done 

$F130 —turn off RTS 

$F 1 38 — wait for DCD to go high 

$F1 3F — enable CB1 for RS232 input 

$F146 — if not 3 line half then see if we need to turn on CB1 

$F14F — input a character buffer handler 

$F1 5C — receiver always runs 

$F160 —protect serial/cassette from RS232 NMI's 
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'— PARITY ERROR BIT 



FRAMING ERROR BIT 



RECEIVER BUFFER OVERRUN BIT 



UNUSED 



CTS SIGNAL MISSING BIT 



UNUSED 



DSR SIGNAL MISSING BIT 



BREAK DETECTED BIT 



RS-232 STATUS REGISTER —$0297 



Fig. 35 - Function of bits in VIC RS-232 Status register. 
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Using the RS232 Port 
Opening an RS232 Channel 

Basic Syntax: OPEN If, 2, 0, "(control register) (connmand 

register)" 

If — Normal logical file ID (1-255). If lf)127 then line feed follows 
carriage return 

(control register) — an ASCII character equivalent to the required 
bit setting of the Control Register. Exannple: to set baud rate to 300 
and transmit 7 bit code use CHR$(6-f32) — this sets bits 1, 2 and 5 to 
logic '1 ' and leaves the rest at logic '0'. 

(command register) — an ASCII character equivalent to the required 
bit setting of the Command Register. Example: to set the output to 
mark panty and full duplex use CHR$(32-f 128) — this sets bits 5 and 7 
to logic '1 ' and leaves the rest at logic '0'. 

Machine Code Entn/ Point: Hex $FFCO 

Notes on Usage: Only one RS232 channel should be open at any 
time, since the OPEN statement resets the buffer pointers, a second 
OPEN will destroy any data in the buffers set up in the first OPEN. The 
OPEN RS232 channel command should be used before any variable or 
DIM statements, failure to do this will cause wiping of data. This is 
because the OPEN RS232 channel command performs an automatic 
CLR before allocating the 512 bytes at the top of memory used for the 
two RS232 data buffers. If there is insufficient space at the top of 
memon/ for the 512 byte buffer then program destruction will result. 
The file name field in the OPEN command statement can have up to 
four characters, only two characters are currently used by the system 
(see Basic syntax) the other two characters are for future systems 
options. No error checking is done by the system on the contents of 
the control or command characters, errors in baud rate selection will 
cause system malfunction. A non-implemented baud rate will cause 
an index to bad page data, and output will be set to a rate below 50 
baud. 
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Receiving Data From an RS232 Channel. 

Basic Syntax: GET # If, (string variable) 

If — logical file ID used in OPEN RS232 channel connnnand 

Machine Code Entn/ Points: 

$FFC6 — Open channel for Input. Handles full X-line innplementation 
according to EIA standard RS232C interfaces. The RTS, CTS and DCD 
lines are innplennented when the VIC is designated as a Data Ternninal 
device. 

$FFE4 — Get character from buffer 

Notes on Usage: Received data is put into the VICs 255 byte 
interna! receiver buffer set up during the OPEN RS232 channel 
command. Data input is under control of the 6522 timers and 
interrupts and is performed in the background during the running of a 
Basic program. This is done by having the RS232 data input line 
connected to the CB1 handshake line, an input on CB1 will generate 
an NMI system interrupt. The use of NMI interrupts is the reason why 
the cassette and serial bus should not be used during RS232 data 
communications. The NMI interrupt will call the serial data input 
routines whenever data is present on the RS232 input. These routines 
will place the received data into the 255 byte receiver buffer located at 
the top of RAM memon/. If the input data has a word width less than 
eight bits then all unused bits will be filled with zero. 

The receiver buffer is organised as a First In First Out — FIFO — 
buffer. The buffer removes the necessity for Basic to wait for data 
input before processing each byte of data. Instead the Basic program 
can take data from the buffer when it needs it rather than when it is 
presented. Basic accesses the buffer using the GET command to 
transfer a single byte of data into a Basic variable. If there is no data in 
the buffer then the GET pf: command will return with a null 
character. If the buffer should overflow then all characters received 
during the overflow condition are lost, an overflow condition is 
indicated by bit 2 in the RS232 Status register being set. An overflow 
condition will frequently result, if an attempt is made to input data at 
fairly high data rates using Basic. This is because Basic is normally 
slow and the use of the GET command with string concattination will 
give rise to frequent garbage collects. Machine language routines are 
best used for data rates above the normal 300 baud. 
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Transmitting Data to an RS232 Channel 

Basic Syntax: CMD If 

PRINT # If, (variable list) 

If — logical file ID set up in the OPEN RS232 channel connnnand 
Machine Code Entn/ Points 

$FFC9 — Open channel for output. This handles X-line handshaking 
for the innplementation of an EIA standard RS232 interface. The RTS, 
CTS, and DCD lines are implennented with the VIC as a Data Terminal. 

$FFD2 — Output character to channel 

Notes on Usage: When either one of the two Basic commands are 
used data is first transferred from the assigned string or memon/ block 
to the 255 byte transmitter buffer. From here it is output to the RS232 
channel using the format and baud rate assigned in the OPEN RS232 
channel command. Data output is transparent to the operation of 
Basic since the timing is done by the 6522 timers and output of each 
byte initiated by an NMI system interrupt. As with data input on the 
RS232 the cassette or serial IEEE port should not be used during data 
transmission on the RS232 otherwise interrupt conflicts will occur. 
There is no carnage return delay implemented by the output channel, 
therefore a normal RS232 printer cannot correctly output the data, 
unless some form of internal buffering or other hold-off is 
implemented by the printer. If a CTS handshake is implemented (in 
the X-line mode) then the VIC buffer will fill, and output will not 
occur until transmission is allowed by an input on CTS. 

Closing an RS232 Data Channel. 

Basic Syntax: CLOSE If 

If — logical file ID set up in the OPEN RS232 channel command 
Machine Code Entn/ Points 

$FFC3 — Close logical file 

Notes on Usage: Closing the RS232 file causes all the data in the 
buffers to be discarded, stops data transmitting or receiving, sets the 
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RTS and SOUT lines high, and de-allocates the mennory area used for 
the RS232 buffers. Closing the RS232 file will also allow the cassette 
or serial IEEE ports to be used. Before closing the channel care should 
be taken to ensure that all data in the buffer is transmitted. This can be 
done by checking the status (ST variable is = 0) and that bit 6 of 
parallel Port A of VIA No. 1 location 37151 is set to logic 1, if both are 
true then there is still data in the buffer. 
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THE JOYSTICKS 

Two different types of joysticks can be attached to the VIC, a sinnple 
paddle switch joystick, and a potentiometer joystick. The principle 
application for joysticks is in interactive games and simulation 
programs. The joystick is used to control the position of an object on 
the screen, this can be either the cursor or a special graphics character 
or characters. Alternatively the cursor can be used to change the 
viewing position, using the joystick like the control stick on an 
aircraft. The choice of which type of joystick is used depends on 
whether fine positional control or simple left, right, forward or 
backward input is required. If fine positional control is required where 
a particular joystick position has a unique value, then a potentiometer 
joystick is required. If simply telling the computer the direction of the 
joystick movement, using one of eight directions is adaquate, then a 
switch joystick is the best choice. 

Switch Joystick 

A switch joystick consists of four switches mounted at right angles 
to each other. The joystick handle is connected to a mechanism which 
allows no more than two adjacent switches to be closed at any one 
time. The joystick handle has nine possible positions: 

one with no switches closed — the handle is vertical 

four positions with one switch closed — handle in north, south, 
east, and west positions. 

four positions with two switches closed — handle in north east, 
south east, south west, and north west positions 

An extra switch is usually mounted on the end of the joystick 
handle, called the 'Fire button'. This is usually used to indicate to the 
computer when the cursor or games figure is in the right position on 
the screen. Each of the switches is connected to one of the I/O lines 
from the 6522 VIAs. The joystick switches are arranged as follows: 

Button' Switch 4 Swkch TOP (north) 



Switch 2- 



-Switch 3 



Switch 1 



216 





PIN 


TYPE 


NOTE 


1 


JOY0 




2 


J0Y1 




3 


J0Y2 




4 


J0Y3 




5 


POT Y 




6 


LIGHT PEN 




7 


+ 5V 


MAX 100mA 


8 


GND 




9 


POT X 





Fig. 36 — The allocation and function of pins on the Joystick connector. 



+ 5V 




100 k ohnn 



POT X or 
POT Y input"^ 



•1mfd 



-Zr GND 
Fig. 37 — Potentiometer joystick circuit. 
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Switches 0, 1 and 2 and the 'Fire button' are connected to lines from 
VIA No. 1., and switch 3 to a line fronn VIA No. 2. The VIA nnennony' 
locations used by the switch joystick are as follows: 

Hex Decinnal Function 

$9113 371 39 Data Direction Register for Port A VIA No. 1 . 

$9111 37137 Output Register A 

bit 2 — joystick switch 
bit 3 — joystick switch 1 
bit 4 — joystick switch 2 
bit 5 — 'Fire button' 

$91 22 371 54 Data Direction Register for Port B VIA No. 2. 

$9120 37152 Output Register B 

bit 7 — joystick switch 3 

To read the joystick switch inputs the I/O lines used nnust first be set 
into the input nnode. Achieved by setting the corresponding bit of the 
Data direction Register to 0. This poses one problenn, the line used for 
joystick switch 3 is also used for scanning the keyboard. Thus the 
keyboard can not be used in full at the sanne tinne as the switch 
joystick, and the Data Direction Register should always be restored 
to normal after the joystick is used. The following progrann can be 
used to initialise the Data Direction Registers and input the switch 
position. 

10 POKE 37139,0 : POKE 37154,127 : setupDDRs 

20 S = PEEK (371 37) : input from VIA No. 1 . 

30 SO = ((S AND 4) =) : switch 

40 SI = ((SANDS) : switch 1 

50 S2 = ((S AND 1 6) = 0) : switch 2 

60 F = ((S AND 32) = 0) : 'Fire button' 

70 S = PEEK (371 52) : input from VIA NO. 2. 

80 S3 = — ((S AND 1 28) = 0) : switch 3 

90 POKE 371 54,255 : restore keyboard function 

The variables SO, SI, S2 and S3 will normally be but if the joystick 
handle is pointed in that direction their value will be either 1 or — 1. If 
the 'Fire button' is pressed then the variable F will have a value of 1, 
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otherwise it will be 0. These variables can be used to decode the 
the joystick ir^to the following pattern: 

TOP 



7 1 

6 8 2 

5 3 

4 

The following program lines will convert the variables SO, S1 , S2 
and S3 into the values shown in the pattern which correspond to the 
handle position and store in variable P: 

1 00 DATA 7,0,1, 6, 8, 2, 5, 4, 3 : data for joystick pattern 

110 FOR I = 0TO2 

120FORJ = 0TO2 

1 30 READ JS (J, I) : put joystick pattern into array 

140 NEXT J, I 

150X= 1+(S2 + S3) : Y= 1+(S0 + S1) 

1 60 P = JS(X, Y) : set P to joystick pattern value 

Potentionneter Joystick 

A potentiometer joystick consists of two potentiometers mounted 
at right angles to each other in a mechanism which allows the joystick 
when moved to change the wiper position on one or both 
potentiometers. One potentiometer registers the joystick movement 
in the X axis, the other in the Y axis. The rotational movement of each 
potentiometer is divided by the computer into 255 divisions. With the 
joystick centered vertically the X and Y potentiometers will each have 
a value of 128. The position of the joystick can thus be mapped in 
terms of graph co-ordinates, thus: 
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X AXIS POTENTIOMETER 
255 (top) 



128 



Y AXIS 255 
POTENTIOMETER 




128 



■0 (right) 



(bottom) 



The two potentiometers are connected together with a small 
amount of additional circuitn/ to two special inputs on the 6561 VIC 
chip, their pin assignations on the output connector are shown in 
Figure 36, The input to the 6561 is used to convert the potentiometer 
position into a microprocessor readable 8-bit number. This is 
accomplished by a simple RC time constant integration technique. 
The potentiometer is used to charge an external capacitor connected 
to one of the pot pins and ground. This simple circuit is shown in 
Figure 37. 

The 6561 converts the potentiometer position into a value which 
the processor can read by accessing one of the two potentiometer 
registers, the memon/ location of these two registers is; 

Hex $9008 decimal 36872 — digitised value of POT X 
Hex $9009 decimal 36873 — digitised value of POT Y 



I ic vaiuo o 



torod in these two registers can be accessed simply 



using PEEK or LDA commands. 
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THE MEMORY EXPANSION CONNECTOR 

The memory expansion connector allows additional memon/ or i/0 
to be added to the VIC. The 44 line connector gives external 
equipment access to the VIC system data bus and address bus plus 
the necessan/ control lines. These connections are shown in Figure 38. 
The connector required to attach equipment to the expansion 
connector is a 44 pin (22/22) male edge connector with a .156 inch 
connector separation (a double sided etched PC board can be used). 
The user must exercise great care when interfacing equipment to 
these lines, since they are not buffered and any malfunction of the 
external equipment may damage the VIC. The memon/ expansion 
port lines can be divided into five groups: 

Data Bus — the eight data lines used to transfer data between 
processor and memon/. 

Address Bus — the fourteen least significant address lines are 
available, they allow any memon/ location in an 8K block to be 
accessed by the processor. Which of the 8 memory blocks is accessed 
depends on the block select lines. 

Control Bus — the six control lines govern system clock, IRQs, Reset, 
and R/W select. 

Block Select — there are nine block select lines, these are generated 
by partly decoding the most significant address lines. They are used 
to select the block of memon/ or I/O addressed by the I/O bus. 

Power Lines — power output is available at +5 volts and Ground, 
the power rating is approximately 750ma. 

The signals available on the memon/ expansion connector are as 
follows: 



Name 


Pin No. 


Description 


GND 


1 


System Grounc 


GDO 


2 


Data bus lineO 


GDI 


3 


Data bus line 1 


CD2 


4 


Data bus Iine2 


CD3 


5 


Data bus line 3 


CD4 


6 


Data bus line 4 


CD5 


7 


Data bus line 5 
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MEMORY EXPANSION 



12 3 4 5 6 7 8 9 10 1112 13 14 15 16 17 18 19 20 2122 




ABCDEFHJKLMNPRSTUVWXYZ 



PIN# 


TYPE 


1 


GND 


2 


CD0 


3 


CD1 


4 


CD2 


5 


CD3 


6 


CD4 


7 


CDS 


8 


CD6 


9 


CD7 


10 


BLK1 


11 


BLK2 



PIN# 


TYPE 


12 


BLK3 


13 


BLK5 


14 


RAMI 


15 


RAM2 


16 


RAM3 


17 


VR/W 


18 


CR/W 


19 


IRQ 


20 


NC 


21 


+ 5V 


22 


GND 



PIN# 


TYPE 


A 


GND 


B 


CA0 


C 


CA1 


D 


CA2 


E 


GA3 


F 


CA4 


H 


CAS 


J 


CA6 


K 


CA7 


L 


CA8 


M 


CA9 



PIN# 


TYPE 


N 


CA10 


P 


CA11 


R 


CA12 


S 


CA13 


T 


1/02 


U 


1/03 


V 

w 


S02 

NMI 


X 


RESET 


Y 


NC 


z 


GND 



Fjg.38 — The allocation and function of pins on the Memory Expansion 
connector. 
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CD6 
CD7 
BLK1 

BLK2 

BLK3 

BLK5 



CR/W 



9 
10 

11 

12 

13 



RAMI 


14 


RAM2 


15 


RAMS 


16 


VR/W 


17 



Data bus line 6 
Data bus line 7 
8K decoded RAM/ROM block 1 , starting at $2000, 

(active low). 
8K decoded RAM/ROM block 2, starting at $4000, 

(active low). 
8K decoded RAM/ROM block 3, starting at $6000, 

(active low). 
8K decoded ROM block 5, starting atSAOOO 

(active low). 
1 K decoded RAM at $0400, (active low). 
1 K decoded RAM at $0800, (active low). 
1 K decoded RAM at $0C00, (active low). 
Read/Write line fronn VIC chip, (high = read 

low = write). 
Read/Write line fronn CPU. (high = read, 

low = write). 



IRQ 


19 


6502 IROIine, (active low). 


(NO 


20 




+5v 


21 


+5 volt power line. 


GND 


22 


System Ground. 


GND 


A 


System Ground. 


CAO 


B 


Address bus lineO 


CA1 


C 


Address bus line 1 


CA2 


D 


Address bus line 2 


CAS 


E 


Address bus line 3 


CA4 


F 


Address bus line 4 


CAB 


H 


Address bus line 5 


CA6 


J 


Address bus line 6 


CA7 


K 


Address bus line 7 


CAS 


L 


Address bus line 8 


CA9 


M 


Address bus line 9 


CA10 


N 


Address bus line 10 


CA11 


P 


Address bus line 1 1 


CA12 


R 


Address bus line 12 


CA1S 


S 


Address bus line 13 


1/02 


T 


Decoded I/O block 2, starting at $9130 


I/OS 


U 


Decoded I/O block 3, starting at $9140 


S02 


V 


Phase 2 system clock 


NMI 


W 


6502 NMI line, (active low) 


RESET 


X 


6502 RESET line, (active low) 


(NO 


Y 




GND 


Z 


System ground 
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THE SERIAL IEEE PORT 

This IS a very cut-down version of the IEEE-488 port available on PET 
connputers. In the nornnal IEEE, bus data is transferred in parallel fornn 
on eight data lines. In the VIC implementation, it is transferred serially 
on a single line. The VIC IEEE bus consists of just six lines, three output 
and three input. The three input lines carry data and control pulses 
from a communicating device to the VIC, the three output lines have 
an identical function, and output data from the VIC to the peripheral 
device. The three lines consist of a senal data line, a clock line to clock 
pulses off the data line, and a service request or attention command 
line. The functioning of the serial IEEE port on the VIC is ven/ 
rudimentan/ compared to the IEEE implemented on the PET, but is 
adequate for many applications requiring communications between 
the VIC, and, either a penpheral device, other VlCs or a larger 
computer. If the full IEEE-488 bus is required then the IEEE-488 
expansion module should be used. This is ven/ useful if one wishes to 
connect the VIC to other IEEE-488 devices, in particular the PET 
peripherals. 

Definition of the IEEE port 

An IEEE-488 type port, whether the simple senal port available on 
the unenhanced VIC, or the full implementation of the expansion 
module, has considerable advantages over a serial RS232 port or a 
parallel user port. The advantage is that an IEEE-488 type port is 
capable of communicating with more than one device connected to a 
single set of I/O lines. It does this by means of the control lines and a 
strict protocol of commands between the listening device and the 
talking device. There are three classes of device which can be 
attached to the lEE bus, they are: 

Controller — one device which controls bus operation 
Listener — a device receiving data from the bus 
Talker — a device transmitting data onto the bus 

With the existing operating system software in the VIC, only the VIC 
can acL as a controller, though it can also act as either a listener or 
talker. All the peripheral devices can be either listeners or talkers, 
though only one device at a time may be a talker on the bus, Figure40 
shows how the VIC and peripheral devices comimunicate via the IEEE 
bus. The 'controller' as its name implies controls the data transfer 
along the bus, and determines which devices act as 'listeners' and 
which device is the 'talker. It does this by individually addressing each 
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PIN^ 


TYPE 


1 


SERIAL SRO IN 


2 


ONO 


3 


SERIAL ATN IN/OUT 


4 


SERIAL CLK IN/OUT 


5 


SERIAL DATA IN/OUT 


6 


NC 



Fig. 39 — The allocation and function of pins on the IEEE Port connector. 
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Disk Drive 

— talker or 

— listener 


















































Printer 
— listener 











































Fig. 40 — The interconnection of devices via the serial IEEE port. 
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device and sending it a set of connnnands, these set the device as 
either a 'listener' or 'talker' and in addition can control other functions 
of the device. Each device has its own unique address code which is 
usually defined in the devices electronic hardware, the device 
nunnbers can be any value between 4 and 30. Having set up the 
direction of a data transfer of each device and its mode of operation 
the 'controller' sends out a connnnand to initiate data transfer. When 
that data transfer is completed the 'talker' sends a command to the 
'controller' which then sends commands to the bus devices which 
disables them as either 'talkers' or 'listeners'. 

The serial IEEE port connections. 

The SIX I/O lines of the VIC serial IEEE port are derived from the two 
6522 peripheral I/O chips. The following table shows the derivation of 
each line. 



VIA No. 


line No. 


Line function 


VIA1 


PA1 


Senal data in 


VIA 2 


CB2 


Serial data out 


VIA1 


PAO 


Serial clock in 


VIA 2 


CA2 


Serial clock out 


VIA1 


PA7 


Serial ATN out 


VIA 2 


CB1 


Serial SRQ in 



The output connector and the circuit used to input and output these 
lines IS shown in Figure39. It should be noted that the 'ATN in' line is 
not implemented and is simply connected to pin 9 of the user port 
connector. If 'ATN in' is required then the user should connect pin 9 to 
one of the unused user port handshake lines and write the 
appropriate software to handle an 'ATN in' input. 

Using the Senal IEEE Port. 

Whether the IEEE port on the VIC is the simple serial port on the 
unexpanded machine or the full implementation using the external 
IEEE-488 module the Basic command syntax is identical. The 
differences lie in the way the data is transmitted. The commands in 
the following synopsis can be used with either mode of IEEE data 
transmission, providing that the device or devices communicating 
with the VIC over the bus are capable of the selected type of 
com.munications. 
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Opening an IEEE channel. 

Basic Syntax: OPEN If, d, sa, "fn" 

If ^ Nornnal logical file ID (1-255). 

d — Device nunnber (4-30). This selects the device to receive this 
command sequence. A different device number is allocated to each 
device communicating with the VIC via the IEEE bus. 

sa — Secondan/ address (0-31). This code value is used to determine 
the operating mode of an intelligent peripheral. By changing the 
secondan/ address the operating characteristics of the device can be 
changed, the value used and its operation will be unique to the 
addressed device. 

"fn" — File name string. The file name field is an extension of the 
secondary address and is principally used when communicating with 
storage devices such as tape and disk drives. The file name field can 
be either a string, or string variables up to 128 characters long, and is 
used to specify a data item or a file name. The use of a file name and 
the syntax used to construct the string is dependant on the device 
addressed. 

Function of the OPEN Command 

The OPEN command selects a device that has a value between 4 
and 30 and the operating system assumes that the device is an IEEE 
device. If no file name or secondan/ address is specified then nothing 
IS communicated to the peripheral devices from the VIC 'controller'. 
The operating system takes the variables in the OPEN command and 
stores them in the file tables. However, if a file name is specified the 
operating system sends a 'listen attention' sequence to the device 
specified in the OPEN command. The secondan/ address is also 
transmitted with the file name as the hexadecimal or of $F0 and the 
secondan/ address specified in the OPEN command. The VIC 
operating system allows up to ten logical files to be opened at any 
one time. 

Machine Code Entn/ Points for Serial IEEE. 

Set logical, first, and second address — $FFBA 
Set file name — $FFBD 

Open command routine — $FFCO 



227 




, i 


CO 




n 




ID 




LO 




C\J 







1 . ^ 



I :l- 



o 

cc 



Z) 

O 



< 

Q 



> 
O 



2 

o 

cr 



o 

o 
o 



o 

Q. 



U 

> 



C 

o 
(/) 

C 



c 
o 
o 

■D 

c 

CD 

CD 
+-» 
CD 
■D 
H- 
O 

E 

i— 
o 
*+- 

(D 

> 
CD 






228 



Receiving Data From an IEEE Channel 

Basic Syntax; either INPUT # If, V 
or GET ft If, V 

If — Logical file ID specified for the device in the OPEN connnnand. 

V — Input data stored in variable V or VS. 

The INPUT # connmand accepts characters from the peripheral 
and builds thenn up into the variable V. This continues until the 
delinniter character is received. The delimiter character is a carriage 
return (CHR$ 13) and nnarks the end of the input. The variable string is 
built up in the Basic input buffer, this has a maximum length of 88 
characters, an input string should therefore not exceed 88 characters 
between carriage returns. The GET # command is used to get a 
single character from the bus, no delimiter is needed. The GET 
command is also not subject to the 88 character buffer limitation and 
can be used to input or output string greater than 88 characters. 

IEEE Device Input Sequence and Function. 

All INPUT 4 and GET # commands go through the same 
sequence. 

The IEEE initiation routine is first called, this sends a 'Talk Attention' 
sequence to the device, followed by the secondan/ address specified 
for that logical file in the OPEN command. At the end of the 'Attention' 
sequence the VIC establishes itself in the 'listener' mode and waits for 
a signal from the addressed device, indicating that a single character 
has been received. If this signal is not received within 64ms then an 
error is generated and the correct code stored in the status byte, 
variable ST. If the signal is received within the timeout period then 
control is passed to the IEEE input routine. The IEEE input routine gets 
a single character from the bus using the clock line to clock each bit off 
the serial data input line. If during the course of inputting data an EOl 
signal is received then the IEEE routine will set the EOl status flag, this 
indicates that the next byte is the last byte. This calls the termination 
'Untalk' routine which returns command to the keyboard and sends 
an 'Untalk' command to the IEEE bus thereby freeing the bus for the 
next command. Figure 41 and 4 2 show the flow of data between the 
VIC and the serial IEEE bus devices with the relevent pulse sequence 
and timings. 
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Machine Code Entry Points For Serial IEEE Input Routines: 
Connnnand serial bus device to Talk — $FFB4 
Send secondan/ address after Talk — $FF96 
Input byte from serial IEEE port — $FFA5 
Connnnand serial bus to Untalk — $FFAB 
Settinneouton IEEE bus — $FFA2 

Transnnitting Data to an IEEE Channel. 

Basic Syntax: PRINT# If, V 

If — Logical file ID specified for the device in the OPEN connnnand. 

V — Output data stored in variable V or V$. 

IEEE Output Sequence and Function. 

The PRINT # , connnnand first calls a routine which sends a 'Listen 
Attention' connnnand to the addressed device on the bus, this sets that 
device as a 'listener'. This is followed by the secondan/ address byte 
specified for that logical file in the OPEN comnnand. The VIC expects a 
response signal fronn the listening device within 256 jjs otherwise a 
device not present error is signalled. The IEEE output routine then 
transnnits the data in the variable bit by bit down the serial output line 
together with synchronising clock pulses. The output data is stored in 
the Basic buffer prior to transnnission, and it is fronn here that the 
output routine accesses each byte. When the last byte of data to be 
transnnitted is reached the VIC sends an EOl signal to the listener to 
warn the listening device that transnnission is about to end. Having 
transnnitted this last byte the VIC sends an 'Unlisten' connnnand to the 
bus and restores output to the screen. This frees the bus for the next 
operation. Figures 41 and 42 show the flow of data between the VIC 
and a serial IEEE peripheral device, together with the pulse sequences 
and tinnings. 

Machine Code Entn/ Points for Serial IEEE Output Routines 

Connnnand serial bus device to Listen — $FFB1 
Send secondan/ address after Listen — $FF93 
Output byte to senal IEEE port— $FFA8 
Connnnand serial bus to Unlisten — $FFAE 
Set tinnout on IEEE bus — $FFA2 
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Closing an IEEE Channel. 

Basic Syntax: CLOSE If 

If — Logical file ID specified in OPEN conrnnand. 

IEEE Manned Device Closure. 

When an IEEE file which was opened with a file nanne is closed a 
special connnnand sequence is generated. This command sequence 
sends the secondan/ address from the OPEN command ORed with 
hexadecimal $E0 to the device specified. This allows special file 
closure commands to be sent to intelligent peripherals. 

Machine Code Entn/ Point for Serial IEEE Close Routine. 

Close named IEEE device — $FFC3 

Other IEEE Commands 

There are three special IEEE commands, they are: LOAD, SAVE, and 
CMD. The first two are concerned with the transfer of programs 
between the VIC and a peripheral device on the IEEE bus. The last 
command, CMD, is a special form of the PRINT No., command. All 
three commands should be preceded and followed by the OPEN and 
CLOSE command specifying the device number to be accessed. The 
function and syntax of these three commands is as follows: 

Load program from IEEE device. 

Basic Syntax: LOAD fn, d, sa 

fn — File name of program to be loaded into the VIC memon/, may 
contain optional commands to the addressed device such as disk 
drive number. The file name and optional device directive should be 
enclosed in quotes. 

d — Device number defined in the OPEN command, 
sa — Optional secondary address command. 

The first two bytes of data retreived in a LOAD command contain 
the starting address of the program. 
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Save program on IEEE device. 

Basic Syntax: SAVE fn, d, sa 

fn — File nanne of progrann to be saved on peripheral device. The file 
nanne should be enclosed in quotes and nnay contain an optional 
connnnand to the addressed device eg: disk drive nunnber. 

d — Device nunnber defined in the OPEN connnnand. 
sa — Optional secondary address command. 

The starting address of the program in VIC memon/ is transmitted 
in the first two bytes of data. 

The CMD command. 

Basic Syntax: CMD If, V 

If — Logical file ID specified for the device in the OPEN command. 
V — Output data stored in variable V or V$. 

The CMD command is virtually identical to the PRINT No., 
command, except that at the end of data transfer the unlisten routine 
is not called, thereby leaving the device to be commanded by a CMD 
as the primary output device for Basic. PRINT or LIST commands are 
then directed to this device rather than to the video screen. The most 
frequent use of CMD is in obtaining printed program listings. The 
CMD command is terminated by a PRINT No., command being 
executed. 

Important memon/ locations used by the VIC serial IEEE port. 



$90 
$94 
$95 


— The I/O status flag 

— IEEE buffered character flag 

— IEEE buffered character 


$97 

<tOQ 


— Temp for IEEE input 

— Pointer to file table 


$99 
$9A 
$A3 


— Input device No. 

— Output CMD device 

— Serial bit cont/EOI flag 


$A4 


— Cycle counter for serial I/O 


$B7 
$B8 


— Length of current file name string 

— Current logical file number 
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1 



TALKER 



Dout ->high 



Dout 



Timeout Error 
Device not Present 




Din 



Cout -^ high 



Cout 




Cout -^ low 



Cout 



Output data 
byte 



Dout 




Din 



yes 



(A) 
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Din 



Dout 



Cin 



Dout 




Dout -^ low 



Dout -^ high 



LISTENER 






Cin 


^^^^"^""^ C\n = low ^""-^.^.^^^^ 

\.^^^after 256>js ^^^ 


no 




.. _ 




Dout 




VIC is asserimg tui 




] 


yes 


' r 




Dout -^ low 32jjs 


^ 


Dout 


^ 
































• i"y" 





Cin 



Din 




^ 


^ yes 


Input data byte 


1 


' 


Dout -^ low 


^ 


1 


Delay 60^js 
Dout & Cout -> high 



Fig. 42— Flow diagrams of data input and output sequence 
in IEEE port communications. 



234 



$B9 — Current secondary address 

$BA — Current device nunnber 

$BB — Address of current file name string 

$0200 — 88 byte Basic input buffer 

$0259 — Logical file nunnber table, 1 bytes 

$0263 — Device number table, 1 bytes 

$026D — Secondan/ address table, 1 bytes 

$0285 —IEEE timeout flag 

System subroutine locations for serial IEEE 

$E4A0 —Set data line high 

$E4A9 —Set data line low 

$E4B2 — Debounce PIA and shift clock to cam/ 

$EE14 — Command serial bus device to talk 

$EE17 — Command serial bus device to listen 

$EE40 — Output a byte from serial bus 

$EE6F — Set to send data 

$EECO — Send secondan/ address after listen 

$EEC5 — Release attention after listen 

$EECE — Talk second address 

$EED3 —Talk attention 

$EEE4 — Buffered output to serial bus 

$EEF6 — Send untalk command to serial bus 

$EF04 — Send unlisten command to serial bus 

$EF19 — Input a byte from serial bus 

$EF84 — Set clock line high 

$EF8D —Set clock line low 

$EF96 —Delay 1ms 

Vector jump addresses for senal IEEE 

$FF93 — Send secondan/ address after listen 

$FF96 — Send secondan/ address after talk 

$FFA2 — Set timeout on IEEE bus 

$FFA5 — Input byte from senal IEEE port 

$FFA8 — Output byte to senal IEEE port 

$FFAB — Command serial bus device to untalk 

$FFAE — Command serial bus device to unlisten 

$FFB1 — Command serial bus device to listen 

$FFB4 — Command serial bus device to talk 

$FFBA — Set logical, first and second address 
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$FFBD —Set file name 

$FFCO — Perform OPEN command 

$FFC3 —Perform CLOSE command 
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Table of CBM Codes 








DECIMAL 


HEX 


ASCI 


I 


SCREEN 


BASIC 


6502 


DECIMAL 





00 






@ 


end- 1 i ne 


BRK 





1 


01 






A 




ORA(I ,X) 


1 


2 


02 






B 








2 


3 


03 






c 








3 


4 


04 






D 








4 


5 


05 






E 




ORA 


Z 


5 


6 


06 






F 




ASL 


Z 


6 


7 


07 






G 








7 


8 


08 






H 




PHP 




8 


9 


09 






I 




ORA 


7^ 


9 


10 


OA 






J 




ASL 


A 


10 


11 


OB 






K 








11 


12 


OC 






L 








12 


13 


OD 


car 


ret 


M 




ORA 




13 


14 


OE 






N 




ASL 




14 


15 


OF 















15 


16 


10 






P 




BPL 




16 


17 


11 


cur 


down 


Q 




ORA (I ) , Y 


17 


18 


12 


reverse 


R 








18 


19 


13 


cur 


home 


S 








19 


20 


14 


delete 


T 








20 


21 


15 






U 




ORA 


Z,X 


21 


22 


16 






V 




ASL 


Z,X 


22 


23 


17 






w 








23 


24 


18 






X 




CLC 




24 


25 


19 






Y 




ORA 


Y 


25 


26 


lA 






Z 








26 


27 


IB 






[ 








27 


28 


IC 






\ 








28 


29 


ID 


cur 


right 


] 




ORA 


X 


29 


30 


IE 






t 




ASL 


X 


30 


31 


IF 






*- 








31 


32 


20 


space 


space 


space 


JSR 




32 


33 


21 


I 




: 


: 


AND(I ,X) 


33 


34 


22 


" 






" 






34 


35 


23 


^ 




w 


^ 






35 


36 


24 


$ 




$ 


$ 


BIT 


Z 


36 


37 


25 


% 




% 


% 


AND 


Z 


37 


38 


26 


& 




& 


& 


ROL 


z 


38 


39 


27 


' 




' 








39 


40 


28 


( 




( 


( 


PLP 




40 


41 


29 


) 




) 


) 


AND 


w 


41 


42 


2A 


♦ 




♦ 


♦ 


ROL 


A 


42 


43 


2B 


+ 




+ 


+ 






43 


44 


2C 






^ 




BIT 




44 


45 


2D 


- 




- 


- 


AND 




45 


46 


2E 










ROL 




46 


47 


2F 


/ 




/ 


/ 






47 


48 


30 







9 





BMI 




48 


49 


31 


1 




1 


1 


AND< 


:i),Y 


49 
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DECIMAL 


HE 


50 


32 


51 


33 


52 


34 


53 


35 


54 


36 


55 


37 


56 


38 


57 


39 


58 


3A 


59 


3B 


60 


3C 


61 


3D 


62 


3E 


63 


3F 


64 


40 


65 


41 


66 


42 


67 


43 


68 


44 


69 


45 


70 


46 


71 


47 


72 


48 


73 


49 


74 


4A 


75 


4B 


76 


4C 


77 


4D 


78 


4E 


79 


4F 


80 


50 


81 


51 


82 


52 


83 


53 


84 


54 


85 


55 


86 


56 


87 


57 


88 


58 


89 


59 


90 


5A 


91 


5B 


92 


5C 


93 


5D 


94 


5E 


95 


5F 


96 


60 


97 


61 


98 


62 


99 


63 



ASCII 

2 

3 
4 
5 
6 
7 
8 
9 



SCREEN 

2 
3 
4 
5 
6 
7 
8 
9 



5 



6502 


DECIMAL 






50 






51 






52 


AND Z, 


X 


53 


ROL Z, 


X 


54 
55 


SEC 




56 


AND Y 




57 


CLI 




58 
59 
60 


AND X 




61 


ROL X 




62 
63 


RTI 




64 


EOR(I , 


X) 


65 
66 
67 
68 


EOR Z 




69 


LSR Z 




70 
71 


PHA 




72 


EOR 7^ 




73 


LSR A 




74 
75 


JMP 




76 


EOR 




77 


LSR 




78 
79 


BVC 




80 


EOR (I) 


,Y 


81 
82 
83 
84 


EOR Z, 


X 


85 


LSR Z, 


X 


86 

87 


CLI 




88 


EOR Y 




89 
90 
91 
92 


EOR X 




93 


LSR X 




94 
95 


RTS 




96 


ADC(I, 


X) 


97 
98 
99 
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DECIMAL 


HEX 


ASCII 


SCREEN 


BASIC 


6502 


DECIMAL 


100 


64 














100 


101 


65 




r* 






ADC 


z 


101 


102 


66 




■■ 






RCR 


Z 


102 


103 


67 




^ 










103 


104 


68 




=: 






PLA 




104 


105 


69 




9 


^ 




ADC 


y¥ 


105 


106 


6A 




^ 




RCR 


A 


106 


107 


6B 




-T 










107 


108 


6C 




:? 






JMP( I) 


108 


109 


6D 








ADC 




109 


110 


6E 




X 






ROR 




110 


111 


6F 












111 


112 


70 




1 






BVS 




112 


113 


71 








ADC(I) ,Y 


113 


114 


72 




— 










114 


115 


73 




f 










115 


116 


74 




p- 










116 


117 


75 




Lr 






ADC 


Z,X 


117 


118 


76 




^ 






ROR 


Z,X 


118 


119 


77 




J 










119 


120 


78 




^ 






SEI 




120 


121 


79 




— 






ADC 


Y 


121 


122 


7A 






• IZl 








122 


123 


7B 




^ 








123 


124 


7C 




s 










124 


125 


7D 




J- 






ADC 


X 


125 


126 


7E 




1~ 






ROR 


X 


126 


127 


7F 




^ 










127 


128 


80 




™r-0 


END 






128 


129 


81 




r-A 


FOR 


STAd ,X) 


129 


130 


82 




r-B 


NEXT 






130 


131 


83 




r-C 


DATA 






131 


132 


84 




r-D 


INPUT ^ 


STY 


z 


132 


133 


85 




r-E 


INPUT 


STA 


z 


133 


134 


86 




r-F 


DIM 


STX 


z 


134 


135 


87 




r-G 


READ 






135 


136 


88 




r-H 


LET 


DEY 




136 


13 7 


89 




r-I 


GOTO 






137 


138 


8A 




r-J 


RUN 


TXA 




138 


139 


8B 




r-K 


IF 






139 


140 


8C 




r-L 


RESTORE 


STY 




140 


141 


8D 


car ret 


r-M 


GO SUB 


STA 




141 


142 


8E 




r-N 


RETLTIN 


STX 




142 


143 


8F 




r-O 


REM 






143 


144 


9 




r-P 


STOP 


BCC 




144 


145 


91 


cur up 


r-Q 


ON 


STA(I),Y 


145 


146 


92 


TVS off 


r-R 


WAIT 






146 


147 


93 


c lear 


r-S 


LOAD 






147 


148 


94 


insert 


r-T 


SAVE 


STY 


Z, X 


148 


149 


95 




I 


--U 


VERIFY 


STA 


z.x 


149 
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DECIMAL 


HEX 


ASCII 


SCREEN 


BASIC 


6502 


DECIMAL 


150 


96 






r-V 


DEF 


STX Z,Y 


150 


151 


97 






r-W 


POKE 




151 


152 


98 






r-X 


PRINT ^ 


TYA 


152 


153 


99 






r-Y 


PRINT 


STA Y 


153 


154 


9A 






r-Z 


CONT 


TXS 


154 


155 


9B 






r-[ 


LIST 




155 


156 


9C 






r-\ 


CLR 




156 


157 


9D 


cur left 


r-2 


CMD 


STA X 


157 


158 


9E 






r-t 


SYS 




158 


159 


9F 






r- ♦- 


OPEN 




159 


160 


AO 






■ 


CLOSE 


LDY ^ 


160 


161 


Al 


t 




r- : 


GET 


LDA(I ,X) 


161 


162 
163 


A2 
A3 


f 




r-" 


NEW 
TAB( 


LDX y^ 


162 
163 


164 


A4 


^_ 




r-$ 


TO 


LDY Z 


164 


165 


A5 






r-% 


FN 


LDA Z 


165 


166 


A6 


m 




r-& 


SPC( 


LDX Z 


166 


167 


A7 


^ 




r- ' 


THEN 




167 


168 


A8 






r-( 


NOT 


TAY 


168 


169 


A9 


p 


M 


r-) 


STEP 


LDA 7^ 


169 


170 


AA 


^ 




r-* 


+ 


TAX 


170 


171 


AB 


'y 




r- + 


- 




171 


172 


AC 


^ 




r- , 


* 


LDY 


172 


173 


AD 




r-- 


/ 


LDA 


173 


174 


AE 


rL 




r- , 




LDX 


174 


175 


AF 






r-/ 


AND 




175 


176 


BO 


i 




r-0 


OR 


BCS 


176 


177 


Bl 




r-1 




LDA ( I ) , Y 


177 


178 


B2 


-f- 




r-2 


= 




178 


179 


B3 


H~ 




r-3 






179 


180 


&4 


r~ 




r-4 


SGN 


LDY Z,X 


180 


181 


as 


l~ 




r-5 


INT 


LDA Z,X 


181 


182 


m 


J 




r-6 


ABS 


LDX Z,Y 


182 


183 


B7 






r-7 


USR 




183 


184 


B8 


^ 




r-8 


FRE 


CLV 


184 


185 


B9 


■ 




r-9 


POS 


LDA Y 


185 


186 


BA 


J 


.0 


r- : 


SQR 


TSX 


186 


187 


BB 


V 


V- ; 


RND 




187 


188 


BC 




r- 


LOG 


LDY X 


188 


189 


BD 


3- 




r-= 


EXP 


LDA X 


189 


190 


BE 


■~ 




r- 


COS 


LDX Y 


190 


191 


BF 


V 




r-? 


SIN 




191 


192 


CO 








TAN 


CPY ^ 


192 


193 


CI 


i: 


, a 




ATN 


CMP(I),X 


193 


194 


C2 


X 


.b 




PEEK 




194 


195 
196 


C3 
C4 








LEN 
STR$ 


CPY Z 


195 
196 


197 


C5 




. e 




VAL 


CNtP Z 


197 


198 


C6 





,f 




ASC 


DEC Z 


198 


199 


C7 


E 


,g 




CHR$ 




199 
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DECIMAL 


HEX 


ASCI 


200 
201 
202 
203 
204 


C8 
C9 
CA 
CB 
CC 


ZI 


, i 

,j 

, 1 


205 


CD 


x* 


. ^ 


206 


CE 


7 


1 ^ 


207 
208 
209 
210 
211 
212 
213 


CF 
DO 
Dl 
D2 
D3 
D4 
D5 


4 


.P 

,q 

, r 

,s 
, t 
, u 


214 
215 
216 


D6 
D7 
D8 


, V 
, X 


217 
218 


D9 
DA 


, z 


219 


DB 


JI 




220 


DC 


Jf 




221 


DD 


[ 




222 
223 
224 


DE 
DF 
EO 


5 


' 


225 


El 




226 


E2 




227 


E3 




228 


E4 




229 


E5 




230 


E6 




231 


E7 




232 


E8 




233 


E9 




234 


EA 




235 


EB 




236 


EC 




237 


ED 




238 


EE 




239 


EF 




240 


FO 




241 


Fl 




242 


F2 




243 


F3 




244 


F4 




245 


F5 




246 


F6 




247 


F7 




248 


F8 




249 


F9 







SCREEN BASIC 



6502 



DECIMAL 



LEFT$ 
RIGHTS 

MID$ 



INY 


200 


CMP ^ 


201 


DEX 


202 




203 


CYP 


204 


CMP 


20 5 


DEC 


206 




207 


BNE 


208 


CMP ( I ) , Y 


209 




210 




211 




212 


CMP Z,X 


213 


DEC Z,X 


214 




215 


CLD 


216 


CMP Y 


217 




218 




219 




220 


CMP X 


221 


DEC X 


222 




223 


CPX ^ 


224 


SBC(I) ,X 


225 




226 




227 


CPX Z 


228 


SBC Z 


229 


INC Z 


230 




231 


INX 


232 


SBC 7^ 


233 


NOP 


234 




235 


CPX 


236 


SBC 


237 


INC 


238 




239 


BEQ 


240 


SBC(I),Y 


241 




242 




243 




244 


SBC Z,X 


245 


INC Z,X 


246 




247 


SED 


248 


SBC Y 


249 



241 



DECIMAL 


HEX 


ASCII 


SCREEN 


BASIC 


6502 


DECir^L 


250 


FA 






H 


m 






250 


251 


FB 






M 








251 


252 


FC 






E 








252 


253 


FD 






o 






SBC X 


253 


254 


FE 






3 






INC X 


254 


255 


FF 






H 




rr 




255 
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Appendix;^ 2 Wedge Program 



LOC 



CODE 



L I NE 



9600 








, ENTRY CODE 


9600 








, 




9600 










-fr=:$AOOO 


AOOO 


09 


AO 






. WOR START 


Aoor.^ 


2B 


AO 






. WOR PANIC 


A004 


41 


30 






BYT 'AO', *C3> ^tiC2, *CD ; AOCBM 


A006 


C3 










A007 


C2 










AOOB 


CD 










A009 












A009 








i START - SET UP DP SYliTEM 


A009 












A009 


20 


3F 


AO 


START 


JSR MYINIT ; GO RESET SYSTEM 


AOOC 












AOOC 








; START - SET UP BASIC SYSTEM 


AOOC 








, 




AOOC 


20 


13 


AO 




JSR INITVN ; INITILIZE VECTORS 


AOOF 


5B 








CLI 


AOlO 


4C 


7B 


E3 




JMP INITNV ; INITILIZE REST 


A0i3 








; 




A013 








, INITVN . INITILIZE THE VECTORS MY WAY 


A0i:3 








, 




A013 


A2 


OB 




INITVN 


LDX #ITEND-ITI-IGN"1 


A0.15 


BD 


IF 


AO 


INITVL 


LDA ITBGN. X 


A0.18 


9D 


00 


03 




STA lERROR. X 


AOIB 


CA 








DEX 


AOIC 


10 


F7 






BPL INITVL 


AOIE 


60 








RTB 


AOIF 












AOIF 


3A 


C4 




ITBGN 


. WOR NERROR, NMAJN, CNCHST, LISTER, 


Ao;?i 


83 


C4 






BYEBYE, EVALMY 


A023 


81 


AO 








A0;?5 


E3 


AO 








A027 


16 


Al 








A029 


3C 


Al 








A02D 








IT END 




A02B 












A02B 








; PANIC - USE THE OLD RETURN 


A02B 












A02B 


2C 


11 


91 


PANIC 


BIT DIORAH i CLR NMI REQ 


A02E 


20 


3A 


F7 




JSR UDTIM ; CHECK FOR STOP KEY 


A031 


20 


El 


FF 




JSR STOP 


A034 


DO 


06 






BNE PANICl 


A036 


20 


42 


AO 




JSR MYREIT i RESTORE MY I/O SYS 


A039 


6C 


02 


CO 




JMP ($0002) ; RETURN TO BASIC 
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LDC 



CODE 



LINE 



A03C 
A03H 
A03F 
A03F 
A03F 
A03F 
A042 
A045 
A048 
A04B 
A04D 
A0150 
A0^2 
A()55 



4C 56 EF 



20 8D FD 

20 8A FF 

20 F9 FD 

IB E5 



PAN I CI JMP PREND 



J DO AN EXIT 



20 

A9 B9 

8D 

A9 

8D 17 03 

60 



16 03 
A2 



MYINIT - MASTER SET UP CODE 
MYREJ.T - MASTER RESTORE CODE 



MYINIT JSR RAMTAS 

MYREIT JSR MOVOSI 

JSR lOINIT 

JSR CI NT 

LDA #<:TIMI3 

ST A CBINV 

I..DA #>TIMR 

5TA C13INV4-1 
RTS 



; GO TEST RAM 

; MOVE OS VECTORS 



GO INIT SCREEN 
RESET BREAK VECTOR 



A056 
A056 
A056 
A056 
A05B 
A05A 
A05C 
A05E 
A05E 
A060 
A062 



AD A2 

64 Al 

DF Al 

46 A2 

92 Al 

A3 Al 



, DLIST - HOLDS DISPATCH LOCATIONS 

STARTING VALUE @314 
DLIST 

WOR MONTDR-l 
WOR SOUND -1 
. WOR SETPLT-1 
. WOR PL0T~1 
LASTST -©317 

. WOR PDL-1 
. WOR JOY-l 
LASTFN =@321 



, MONITUN 

; SETPLOT 

LAST STATEMENT 
TOKEN VALUE 



LAST FUNCTION 
TOKEN VALUE 



A062 






A062 






A062 






A062 


4D 


41 


A068 


C5 




A069 


53 


4F 


A06E 


AS 




A06F 


53 


45 


A075 


D4 




A076 


50 


4C Af 


A079 


D4 




A07A 


50 


44 


A07C 


CC 




A07D 


4A 


4F 


A07F 


D9 




A080 


00 





; LIST - HOLDS ASCII TOKEN TABLES 

L I ST 

BYT 'MACHIN', <^Crv ; MACHINE 

.BYT 'SOUND', -^AO ; SOUND( 
BYT 'SETPL0',^D4 ; SETPLOT 

. BYT 'PLO', $D4 ; PLOT X, Y 

. BYT 'PD '> *CC ; PDL 

. BYT 'JO'. $D9 ; JOY 
BYT *00 ; END OF LIST TABLE 
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LGC 



CODE 



AOSl 






A081 






AOSl 






A081 






AOGl 






AOSl 


20 


7C C5 


A0S4 


AO 


05 


A086 






A086 


B9 


FB 01 


A089 


FO 


57 


AOSD 


C9 


22 


AOSD 


FO 


^7 


A08r 






A08F 


C9 


41 


A091 


90 


40 


A093 


C9 


5B 


A095 


BO 


3C 


A 097 






A097 






A097 






A097 


84 


Bl 


A099 


A2 


00 


A09B 


86 


OB 


A()9D 






A09D 


38 




A09E 


FD 


62 AO 


AOAl 


FO 


13 


A0A3 


C9 


SO 


A0A5 


FO 


16 


A0A7 






A0A7 


BD 


62 AO 


AOAA 


FO 


27 


AOAC 


30 


03 


AOAE 


E3 




AOAF 


DO 


F6 


A 013 1 






AOB 1 


E6 


OB 


A0D3 


A^ 


Bl 


AOB 5 


A9 




A0EI6 


CB 




A0B7 


B9 


FB 01 


AOB A 


E8 




AODB 


DO 


EO 


AOBD 






AOBD 






AOBD 






AOBD 


A 6 


Bl 


AOBF 


A5 


OB 


AOC 1 


18 




A0C2 


69 


CC 


A0C4 


9D 


FB 01 


AOC 7 






A0C7 


C8 




AOC 8 


E8 




AOC 9 


B9 


FB 01 



NEW CRUNCH ROUTINE 
COME TO HERE ON INDIRECT 
TOKEN CHAR LIST MUST BE <255 CHARS 
COMMAND BUFFER LINE MUST BE <255 CHARS 



CNCHBT JSR NCRNCH 

LDY #5 

LOOPOT LDA BUF-5, Y 

BEQ CNCHRT 

CMP #'" 

BEQ LOOPQT 

CMP #'A 

BCC LOOPBK 

CMP # ' r 

DCS LOOPBK 

TOKEN I ZE IF IN TABLLS 

^3TY TEMP 

LDX #0 

STX COUNT 

LOOP IN SEC 

SBC LIST, X 

DEQ NEXT 

CMP #128 

BEQ DONE 



; GO TOKENIZE ALL OLD SYMBOLS 
SET UP TO TOKENIZE ALL NEW 
SYMBOLS 
; GET DATA BYTE 
IF ZERO THEN EX I"! -RETURN 
CHECK FOR QUOTE CASE 
YES . GOTO QUOTE LOOP 

CHECK IF IN ALPHA RANGE. . . 
NO. . . BELOW 
'Z+1 
NO. . . ABOVE 



LOOP NO LDA LIST, X 

BEQ LOOPBK 

BMI CONTLP 
I NX 

BNE LGGPNO 

CONTLP INC COUNT 

I. DY TEMP 
BYT %A9 
NFX'I INY 

LDA BUF-5, Y 

I.NX 

)3N£ LOOP IN 



; HOLD OLD . Y VALUE 

; FIND TOKEN 

. A MATCHED CHAR 

. A MATCHED TOKEN 

; NO MATCH LOOP 
, AT END OF LIST, DISCARD CHAR 
; AT END OF TOKEN, GO COMPARE 
TO NEX1 
, JMP 

, INC TOKEN. COUNT 
, POINT TO BEGINNING OF CHECK 
; SKIP 1 (LDA ¥i) 

, GET NEXT CHAR 

, NF XT IN LIST 



DONE - STORE TOKEN AND COMPACT 



LDX rEMP 

LDA COUNT 

CLC 

ADC #^314 

STA BUF- 5, X 

INY 
]NX 
LDA BUF-5, Y 



, GET OLD POSIGTICIN 
, GET TOKEN VALUE 



i LAST BASIC TOKEN<-VALUE 
, PUT INTO POSISTION 



.CRUNCH COMMAND STRING DOWN 



245 



LOC 



CODE 



AOCC 


9D 


FB 01 




STA 


BUF-5. X 


AOCF 


DO 


F6 




BNE 


LOOPC 


AODl 


A4 


Bl 




LDY 


TEMP 


A0D3 












A0D3 


ca 




LOOPBK 


I NY 




A0D4 


DO 


BO 




BNE 


LOOPOT 


A0D6 












A0D6 






. QUOTE LOOP 


A0D6 












A0D6 


ca 




LOOPQT 


I NY 




A0D7 


B9 


FB 01 




LDA 


BUP-5. Y 


AODA 


FO 


06 




BEQ 


CNCHRT 


AODC 


C9 


22 




CMP 


# '" 


AODE 


DO 


F6 




BNE 


LOOPQT 


AOEO 


FO 


Fl 




BEQ 


LOOPBK 


aoe;? 












A0E2 


60 




CNCHRT 


RTS 




A0E3 






, LISTER - 


NEW LIS 


A0E3 






VECTOR 


QPLOP T 


A0E3 






, 






A0E3 


08 




LISTER 


PHP 




AOE-q 


C9 


FF 




CMP 


#2r>5 


A0E6 


FO 


2A 




DEQ 


LEX IT 


A0E8 


24 


OF 




BIT 


DORES 


AOEA 


30 


26 




BMI 


LEXIT 


AOEC 


C9 


CC 




CMP 


#@314 


AOEE 


90 


'~>'~> 




BCC 


LEXIT 


AOFO 


28 






PLP 




AOFl 






, 






AOFl 






r PRINT TOKEN IN L 


AOFl 






, 






AOFl 


38 






SEC 




A0F2 


E9 


CB 




SBC 


#©313 


A0F4 


AA 






TAX 




A0F5 


84 


49 




STY 


LSTPNT 


A0F7 


AO 


F"F 




LDY 


#2Df7 


A0F9 












A0F9 


CA 




RESLPl 


DEX 




AOFA 


FO 


08 




BEQ 


RESPRT 


AOFC 






, 






AOFC 


C8 




RESLP2 


I NY 




AOPD 


B7 


62 AO 




LUA 


LIST, Y 


A 100 


10 


FA 




BPL 


RESL. P2 


A 102 


30 


FS 




BMI 


RESLPl 


A 104 












A 1 04 


CB 




RFSPRT 


XNY 




AIO'5 


B9 


62 AO 




LDA 


L 1ST, Y 


A 103 


30 


5 




DMI 


RESEXT 


A 1 OA 


20 


D2 FT 




JSR 


BSOUT 


AlOD 


DO 


FVj 




DNE 


re:sprt 


A.) or 












A 1 OF 


4C 


EF C6 


RLSEXT 


JMP 


PRIT4 


A J. J ;-_' 












A 1 1 2 


ZIB 




L F X I r 


PLP 




A 1 1 3 


4(: 


lA C /• 




^iMP 


NOP LOP 



; UNI ILL WE HIT ENDING 7ER0 
.GET POSISTION, AND CONTINUE 



, IF ZERO THEN AT FND OF LINE 



; MASTER EXIT 



ROUTINE 
THIS ROUTINE 



; SAVE FOR EXIT 
, IF PJ THEN EXIT 



, IF QUOTES ON THEN EXIl 
,]r NOT IN RANGE THFN FXII 



, TOSS STACK WILL USE DJFFERENT 
RETURN 



, GET INDFX 
, SAVE . Y 



, LOOP UNTILL TOKEN FOUND 
. FOUND. PRINT IT 



, L OOP UNTILL NEXT IN LIST 
FOUND 



, FND OF TOKEN 
..PRINT OUT TOKEN LIST 



, ALT DUNE 

, OUTPU r TITE CHAR 



. GO BACK TO BASIC 



. RESTORE STATUS 
, GO BACK TO NORMAL LIST 
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LOC 



CODE 



Al 16 








; BYEBYE - 


THIS IS T 


A .1,1 6 








; 






A116 


20 


73 


00 


BYEBYE 


JSR 


CHRGET 


A119 


C9 


CC 






CMP 


#©314 


AllD 


90 


19 






BCC 


BYERTS 


AllD 


C9 


DO 






CMP 


#LASTST+-1 


Al IF 


BO 


15 






BOB 


BYERTS 


A121 


20 


27 


Al 




JSR 


BYEGO 


A124 


4C 


AE 


7 




JMP 


NEWBTT 


A 127 








.; 






A127 


E9 


CB 




BYEGO 


SBC 


#©313 


A 129 


OA 








ASL 


A 


A12A 


AB 








TAY 




A12D 


B9 


57 


AO 




LDA 


DLIST+1. Y 


A 1 2E 


4H 








PHA 




A12F 


B9 


56 


AO 




LDA 


DLIST, Y 


A 132 


48 








PHA 




Al 33 


4C 


73 


00 




JMP 


CHRGET 


A i 36 














A 136 


20 


79 


00 


BYERTS 


JSR 


CHRGOT 


A 139 


^C 


£7 


{'. 7 




JMP 


NCGNE 1 



; GET THE NEXT CHARACTER 
CHECK TO SEE IF IN OUR LIST 
NO. . LEAVE 

CHECK TO SEE IF BEYOND 
YES. . . LEAVE 

; RETURN 

; SUB @314 
i MULT *2 
, GOTO THE ROUTINE 



; SAME DISPATCH AS GONE 
, RESTORE POINTERS 



A 1 jr 


A 9 


00 




L -MLMY 


LDA 


#0 


, COPY FROM EVA 


A13L 


8 5 


01.) 








^JTA 


VALTYP 




A 140 


,70 


7 3 


OC' 






JSR 


CMP GET 




A.l 43 


C9 


DO 








CMP 


#LASTBTf] 


, IS IT IN RANGE 


A, 1 /| '?■> 


90 


i. ;:^ 








IJCC 


EVALLV 


. NO 


t\ 1 '\ 7 


C9 


)■);;■ 








CMP 


#LASl"FN-i-l 




A ,1 4 9 


DO 


or 








IJCS 


EVALLV 


, NO . . 


A 1 '\ B 


b9 


CP, 








3BC 


#(•^313 


; SUB e314 


A 1 '\ ] J 


OA 










ASL 


A 


, NUL^2 


AJ4K 


AH 










fAY 






AI4r 


7 


I")/ 


A(j 






LDA 


DL ISI vl , Y 




AI',/2 


4n 










PHA 






A 1. 'y:i 


D9 


'bt- 


r77} 






KDA 


Dl. ] ST. Y 




i\\\U^ 


'V<\ 










PhlA 






A i 'v; 


^C 


/ 3 









JMP 


CMP OPT 




A.I '/A 


















A1"3A 


A 5 


.' A 




I-: OALl, 


V 


LDA 


r X r V T R 


, [<ACK UP ( X1PT 


Ai^;c 


DO 


o;.? 








WHY. 


LVAI.R r 




A 1 ^)E 


C6 


m 








DF(, 


rx TP TP-i 1 




A 1 /.O 


C6 


7 A 




EVALP 


\ 


DEC 


1 X IPTP 




A 162 


^■IC 


8/. 


CM 






JMP 


NLVAL 
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LOC 



CODE 



A165 








, S0UND(X1, 


X2. X3, X4, AM) 


A165 
















A165 


A2 


00 




SOUND 


LDX 


#0 


. INDEX 


A 167 


SE 


00 


01 


SLOOP 


STX 


FBUFFR 


, IN A TEMP 


A16A 


20 


9E 


D7 




vJSR 


GE TBYT 




A16D 


AB 








TAY 




SAVE CHRQOT 


A16E 


8A 








rxA 






A16F 


AE 


00 


01 




LDX 


FBUFFR 


COUNT 


A172 


9D 


01 


01 




BTA 


FBUFFR+1, X 


INDEX INTO TEMP ARtA 


A175 


E8 








INX 






A 176 


EO 


06 






CPX 


#6 


CHECK FOR 100 MANY P 


A 178 


BO 


OB 






BCS 


SDERR 


YES. . TOO MANY 


A17A 


20 


73 


00 




JSR 


CHRGFT 


GET NEXT CHAR 


A17D 


CO 


29 






CPY 


#' ) 


AT END?. . . 


A17F 


FO 


07 






BEQ 


SMOVR 


YE S3 EXIT TO MOVER 


A 1 !-3 1 


CO 


2C 






CPY 


# ' , 


MUST HAVE GOTTEN A S 


AJB3 


FO 


E2 






DEQ 


SLOOP 


YES CONTINUE 


A]Olv 
















AlSf> 


AC 


08 


CF 


SDERR 


JMP 


SNERR 


, SYNTAX ERROR 


A. 188 
















A 1 83 


CA 






SMGVR 


\)E X 






Aia9 


BD 


01 


01 


SMO^A 


LDA 


FBUFFR+1. X 


, MOVE TO VIC REGS 


AISC 


9D 


OA 


^?0 




GTA 


VICREG+10, X 




A.18F 


CA 








DFX 






A 190 


10 


p.-/ 






DPI. 


SMUVL 




A]9L^ 


60 








Rin 
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CODE 



LINE 



A 193 
A193 
A 193 
A196 
A19S 
A19A 
A19D 
AIAO 
AlAl 
AJ A4 
A1A4 
A1A4 
A1A4 
A1A7 
A IAS 
AlAA 
AlAD 
AlBO 
A1U3 
A 1 D 5 
A .1 B 5 
A 107 
AJDA 
A.1BC 
AlBF 
A ICO 
A ICO 
A,1C3 
AiC6 
A. I CO 
AlCB 
A J C 9 
A. I CO 
A .1 C C 

A ice: 

AIDO 
AID? 
A J D3 
A1D4 
A1D6 
A1D8 
A1D9 
A 1 DA 
A I DC 
AIDD 
A 11-0 
A. .1 f- O 
AJFO 
AlhO 
A J ^f O 
AJEO 
AJEO 
A J EO 
AlE'O 
AlEO 



PDL(X) OR PDL X 



X---0 OR 1 



20 9E D7 

EO 02 

90 03 

4C 48 D2 

BD OS 90 

AS 

4C A2 D3 



20 
78 
A 2 
BE 
AC 



9E D7 



7F 

22 91 
20 91 

CC 20 91 

DO EG 



91 



A2 FF 
8E 
A2 F7 
BE 20 9 1 
58 



AD IF 
CD IF 
DO FS 

4y 

29 1 C 
4A 

CO BO 

90 02 



91 



1 O 



09 

AB 

68 

29 20 

C9 20 

98 

6 A 

49 BF 

Ai] 

4C A 2 



PDL JSR GETBYT 

CPX #2 

BCC *-+5 

PDLERR vJMP FCERR 

LDA VICREG+S. X 

TAY 

JMP SNGFLT 



; ONLY OR 1 
i OKAY 
> ILLEGAL QUANirnY 



, MAKE IT A NUMBER 
JOY (X) XMUST BE A BYIE VALUE 



JOY JSR GETBYT 

RED JOY SEJ 

LDX #*7F 

STX D2DDRB 

JDYLPl LDY D20RB 

CPY D20RB 

BNE JOYLPl 

LDX #*FF 

STX D2DDRB 

I.DX #$F7 

STX D2GRB 
CLI 

J0YI.P2 LDA DIOR A 

CMP DIOR A 

)3NE JOYLP;? 



, CANNOT INTERRUPT 
i GET JOYS 

, RESET DDRB 

, RESTORE STOP KEY CHECK 
-RESTORE IRO'S 
; GET JOYO, 1,2 ?/ BUTI ON 



PHA 

AND #'/00011100 , MASK OF JOYS 

LSR A , MOVE DOWN ONE 

CPY #1^80 , CHECK FUR A JC)Y3 

BCC J0YLP3 

ORA #7»00010000 , GM , TURN ON 
JGYLP;! TAY , MOVE FG TEMP 

PLA 

AND tr/.OOlOOOOO , MASK ON BUI TON 

CMP #7-00100000 .CHECK FOR EXISTANCE 

TYA 

, MOVE SO 7--BUTTGN 32J0-JGY1: 
-FLIP SO PGS LOGIC 

, MAKE i; T A NUMBER 





RfJR A 




FOR #7,10001 i 1 I 




TAY 




JMP SNGFF T 




END 




LIU PLOT 


QPPNt 


<».FD 


TEMPI 


■*FIJ 


TFMP2 


-*FC 


QRBCRN 


-^.1 000 


C DLL JIM 


-l/.() 



PI. or LOGIC 
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A1£0 






5ETPL T 






AlEO 


A2 


00 




LDX 


#0 


A1E2 


AO 


10 




I.DY 


#*10 


A1E4 


IB 






CLC 




A1E5 


20 


99 FF 




sJSR 


MENTDP 


A1E8 


A9 


IE 




LDA 


#*1E 


AlEA 


85 


FE 




STA 


QRPNT-* 1 


AlEC 


86 


FD 




BTX 


GRPNT 


AlEE 


8A 






TXA 




AlEF 


AS 






TAY 




AlFO 


48 




SCRNL 


PHA 




A 1 F 1 


A2 


13 




LDX 


#19 


A1F3 


91 


FD 


SCRNM 


STA 


(GRPNT ) Y 


A1F5 


IG 






CLC 




Air 6 


69 


OA 




ADC 


#10 


A.IF8 


C8 






]NY 




A1F9 


DO 


02 




HNE 


GK 


AlFB 


E6 


FE 




TNC 


GRPNT+1 


AJ.FD 






OK 






AJFD 


CA 






HEX 




A1F"E 


DO 


F3 




I3NE 


SCRNM 


Ar200 


68 






PL A 




a;20 \ 


18 






CI.C 




f\'202. 


69 


0.1 




ADC 


#1 


A204 


C9 


OB 




CMP 


#1 1 


A206 


DO 


EB 




DNE 


SCKNL 



■ MOVE TOP OF MEMORY DELDW HI REL> 



-SCREEN RAM WILL BE AT *lt00 



, SET UP SCREEN SO ALL CHARACTLHS 
(START WITH CHARACTER O 

, SAVE "BABE" CHAR AC"! ER/PO 1 NTFR 
, 19 CHARACTERS PER LINE 

, PUT THE CHARACTER POINTER 



. GPT BASE CHAR 



, AL l_ 190 CHARACTERS UP YET ■ 



A20B 


A 9 


15 




A20A 


SD 


03 


9( 


A20D 


AD 


02 


9(: 


A210 


29 


BO 




A 2 1 :' 


09 


13 




A2M 


8D 


02 


9( 


A2L7 


A'-:? 


PO 




A2 1 9 


2D 


00 


'V( 


A21C 


09 


OC 




A2 I E 


QD 







A221 








A 2;? 1 


A 2 


02 




A223 


AO 


00 




A22'o 


AD 


36 


oz 


A;_'2R 








A228 


99 


00 


sv 


A;:'2r3 


99 


00 


9 :- 


A2;:'E 


C Q 






A2;:'r 


DO 


\" 7 




a; ;3 1 








A231 


A 9 


] 




A233 


80 


FE 




A235 


A 9 


00 




A237 


80 


FD 




A239 


A 8 







1 DA 


#* 1 


STA 


VICREG-t-3 


LDA 


VICREG+2 


AND 


#*8(J 


(DRA 


#3^13 


STA 


VICRPG+2 


LDA 


#i>ro 


AND 


VICREG+0 


ORA 


#*0C 


STA 


VICREG+0 


LDX 


#2 


1 DY 


#0 


1-DA 


COLOR 


STA 


$9600, Y 


STA 


$9 700, Y 


I NY 




13 NP 


CLOOP 


1 DA 


#$[0 


STA 


GRPNT M 


LDA 


#(j 


\r\f\ 


GRPNT 


f AY 




1. DX 


#14 



, SE- f VIC FOR 10 ROWS 

, GET CURENT COLUMNS 

, KEEP THIS PI I 

, OR IT WI EH 19 CE^LUMS 



, MAKE SURE KATAKANA IS OPT 
, PUT VIC IN HI-RPS AT $1000 
, SE:T VIC CHAR ADR5 TO tlOOO 
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LOG 



CODE 



A23C 






A2:3C 


91 


FD 


A;23b- 


C8 




A23F 


DO 


FB 


A24 1 


E6 


FE 


A243 


CA 




A244 


DO 


F6 


A246 


60 




A247 






A247 


20 


9E D7 


A24A 


EO 


98 


A24C 


90 


02 


A24E 


A2 


97 


A2r^0 






A2:50 


86 


FB 


A252 


20 


FD CE 


A255 


20 


9F D7 


A 2:3 8 


EO 


AO 


A25A 


90 


02 


A2r;C 


A2 


9F 


A2:3E 






A2'r5F 


86 


FC 


<y,'JA) 






A2('j0 


AT) 


FD 


A 262 


4 A 




A263 


4 A 




A264 


4A 




A26 5 


OA 




A266 


AA 




A267 


DD 


88 A 2 


A26A 


sr^ 


FD 


A26C 


BD 


89 A 2 


A26F 


85 


FE 


A27 1 






A271 


A^ 


FE 


A273 


29 


07 


A27"; 


AA 




A276 


BD 


90 A 2 


A279 


A4 


FC 


A 27 LI 


1 1 


FD 


A27D 


9.1 


FD 


A27F 


60 




A280 


80 




A2B1 


40 




a;? 8 2 


20 




A2B3 


10 




A2B4 


08 




A2B5 


04 




A2B6 


02 




A 20 7 


01 





STA (QRPNT)Y 

INY 

ONE CLRIT 

INC QRPNT+-] 

DEX 

BNE CLRIT 

RTS 



JSR QETBYT 

CPX #1^72 

nCC DTAOK 

LDX #rji 

STX TEMPI 

J'3R CHKCOM 

JSR GETBYT 

OPX #160 

BCC YI80K 

l_DX #ir79 

^rrX TEMP 2 



FDA 
FSR 
LSR 
LSR 
ASL 
TAX 
LDA 
FJTA 
l_DA 
FIT A 

I. DA 
AND 
TAX 
LDA 
LDY 
("JRA 
STA 
R fS 



> GT T X VALUE 
, DIVIDE BY 8 
, TO GEI TABLE INDEX 

.MAKE IT AN ADDRESS INDEX 



GRTDLE. X -OLI LO DYT OF COL UMN PC)1N-|ER 
QRPNT .POINT INDIRECT MERE 
GRTBL.E-t 1 , X 
GRPNT+l 



TEMP L 
#7 

XBITS. X 
TEMP 2 
(GRPND y 
(GRPNT ) Y 



. GFT ThlE BIT TO 3L\ 



. GET BIT FROM TARL E 
. GEI ROW INDEX 
i SET THE BIT 

.DISPLAY rr 



BYT $80. ^iAO, %20, -blO, *00, $04, 1>02, *01 
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A288 
A2B8 
A288 
A?88 
A288 
A288 
A288 
A288 
A288 
A28S 
A2S8 
A288 
A288 
A288 
A2B8 
A20a 
A203 
A288 
A288 



COLO^GRSCRN 

C0L1=C0L0+C0LLEN 

CGL2=C0L1+C0LLEN 

C0L3=CDL2+C0LLEN 

CDL.4-C0L3-t-C0LLEN 

C0L5=C0L4+C0LLEN 

C0L6=C0L5+C0LLEN 

C0L7=C0L6+C0LLEN 

C0LB=^CDL7+CDLLEN 

CaL9=CaL8-t-C0LLEN 

COL 1 0---C0L9+C0LLEN 

COLl 1-^COLlO+COLLEN 

CaL12^--C0Ll l+COLLEN 

CaL13^^C0L12+C0LLEN 

C0Li4-CDL13^C0LLEN 

C0L15=C0L14-t-C0LLEN 

COL 1 6-^ COL 1 5+COLLEN 

CGL17-CaL16+C0LLEN 

C0Li8--C0L17+C0LLEN 



A2BS 
A28A 
A28C 
A20E 
A290 
A292 
A294 
A296 
A29S 
A29A 
A29C 
A29E 
A2A0 
A2A2 
A2A4 
A2A6 
A;2Ae 

a;2aa 

A2AC 



00 
AO 
40 
EO 
BO 
20 
CO 
60 
00 
AO 
40 
EO 
80 
20 
CO 
60 
00 
AO 
40 



10 
10 
11 
11 

12 
13 
13 
14 
15 

ir? 

16 
16 
17 
IS 
10 
19 
lA 
lA 
IB 



GRTDLE WOR 


COLO 


WOR 


COLi 


. WOR 


C0L2 


. WOR 


cnL3 


WOR 


C0L4 


. WDR 


COLfj 


WDR 


C0L6 


. WOR 


COL 7 


WOR 


COLO 


WGR 


C0L9 


WOR 


COLIO 


WOR 


COLl 1 


WOR 


C0L12 


WOR 


COL 13 


WOR 


COL 14 


WOR 


COL ID 


WOR 


C0L16 


WOR 


C0L17 


WOR 


CDL18 
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Appendix -;Cr 3 







6502 


Instruction 


Set - 


Hex 


an 


d T 


imin 


g 


















IMPLIED 


ACCUM . 


ABSOLUTE 


ZERO PAGE 


IMMEDIATE 


ABS. X 


MNEMONIC 




OP 


n 


# 


OP 


n 


H 


OP 


n 


# 


OP 


n 


ft 


OP 


n 


* 


OP 


n 


^ 


ADC 


(I) 














6D 


4 


3 


65 


3 


2 


69 


2 




7D 


4 


3 


AND 


(I) 














2D 


4 


3 


25 


3 


2 


29 


2 


2 


3D 


4 


3 


A S L 










OA 


2 


I 


OE 


6 


3 


06 


5 


2 








IE 


7 


3 


B C C 


(2) 






































B C S 


(2) 






































B E Q 
B I T 


(2) 














2C 


4 


3 


24 


3 


2 














B M I 


(2) 






































B N E 


(2) 




































li P L 


(2) 




































H R K 




00 


7 


I 






























H V C 


(2) 




































;•. V S 


(2) 






































C L C 




18 




I 
































C L L) 




D'd 




I 
































C L I 




^)P> 


2 


I 




















1 










C L V 
CMP 




BB 




I 








CD 


4 


] 


C5 


] 


2 


C9 




^' 


DD 


4 


] 


C P X 
















EC 


4 




E4 


i 


2 


EG 




2 








C P Y 
















(X^ 


4 


\ 


C4 


5 


1_J 


CO 


2 


1^ 


J 






D E C 
















CE 


f-) 




C(> 


5 








DI- 


-2 ' , 


D i: X 




CA 




I 






























D E Y 




Hh] 


2 


I 




























E R 


(I) 












4D 


4 


^ 


4 5 


^ 


^' 


4 9 




2 


5D 


4 




I N C 
















EE 


f^ 


^ 


''■'■ 










1 


FI' 




\ 


I N X 




EH 


2 


I 
























1 N Y 




CH 


2 


I 






























J M P 














4C 


' * 










i 








J r. F^ 














2 


G ! 








1 










L. D A 1 


( I) 












ADj 


■1 


^ 


AS 


i 




AO 




.:" 


HD 


4 


^ 


L [) X 


( I ) 












AE 


.1 


? 


A(> 






A,' 


2 










L D Y 


(T) 








1 


AC 


4 


j 


A 4 


, 




A(J 






BC 


4 




L S R 










4A 


2 


1 


•IE 


C 


•; 4<; 2 








i '"'^^ 




] 


N P 




EA > 


I 




























R A 














OD 


4 


i 


5 






O'i 


--- 




ID 


4 




P U A 




AH •; 
























P H P 




OR M 1 I 
































P L A 




(>f 


T 


























R E 


r" " 


2A 


2 I 


2E^ 
(>E 


(. 


5 


2(, 


r, 






j 


a-: 






R R 


1 




1 (.A 


2 i I 


(- 


^() 


5 










-/I-; 


'7 




R I^ ] 


MO 


'' i i i ' 1 i 






















R T .'> 


:' ^O 


(, : I 


1 ! I 


1 




! 




! 


1 




S B C 
:-. E C 
S E D 


(I) 


EM 


I 
- 1 ^ 






}•;[) 


4 [ < 

„ „ 1 


E5 
1 , 


'. 




E9 




1 


"' 







S E I 




7;-; 


2 : I 










1 














S T A 




i 1 


:2D 


4 


', |H2 














S T X 






i 1 -I-; i -5 


< h<^ 2 














S T Y 


\ \ : \ 


i 


















T A X 




AA , .' , I 


[ 


1 
















- . -^- S J 


- - 




T A Y 




A':' ,' 1 










i 












T S X 


;ha 1 .; i i 


























T X A 




.A 


■: 1 . 














' 






I 


T X S 
T Y A 




'3A 
9H 


I 
J I 




1 








_J^ 






1 
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ABS. Y 


(IND. X) 


(IND) Y 


Z.PAGE,X 


RELATIVE 


INDIRECT 


Z.PAGE,Y 


PROCESSOR 
STATUS CODE 


OP 


n 


# 


OP 


n 


n 


OP 


n 


/?( 


OP 


n 


// 


OP 


n 


il 


OP 


n 


ft 


OP 


n 


n 


N V BDIZC 


79 
39 


4 

4 


3 
3 


61 
21 


6 
6 


2 


71 
31 


5 

5 


2 


75 
35 
16 


4 
4 
6 


2 
2 


90 
BO 


2 


2 














• • •• 

• • 

• •• 


























FO 

30 
DO 
10 


2 

2 
2 


2 














• 
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Appendix ;zy 5 
Circuit Diagrams 
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Circuit 3 
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APPENDIX 6 

COMMANDS USED BY VIC MACHINE CODE MONITOR 
All commands are displayed in BOLD TYPE 

simple assembler 

.a 2000 a9 12 Ida No. $12 
.A 2002 9D 00 80 STA$8000,X 
.A 2005 DEX GARBAGE 

In the above example the user started assembly at 2000 hex. The 
first instruction was load a register with immediate 12 hex. In the 
second line the user did not need to type the A and address. The 
simple assembler retyped the last entered line and prompts with the 
next address. To exit the assembler type a return after the address 
prompt. Syntax is the same as the disassembler output. A ':' can be 
use to terminate a line. 

disassembler 
.d 2000 

., 2000 A9 12 LDANo. $12 

., 2002 9D 00 80 ST A $8000, X 

., 2005 A A TAX 

disassembles to the end of memory starting at 1000 hex. The three 

bytes following the address may be modified. Use the CRSR keys to 

move to and modify the bytes. Hit return and the bytes in memory 

will be changed. Monitor will then disassemble that line again. 

.d 2000 3000 

disassembles from 2000 to 3000. 

fill memory 
.f 1000 1100 ff 

fills the memory from 1000 hex to 1100 hex with the byte ff hex. 

go run 

-g 

go to the address in the pc register display and begin run code. All 
the registers will be replaced with the displayed values. 

.g 1000 

go to address 1000 hex and begin running code. 

hunt memory 

.h cOOO dOOO 'read 

hunt through memory from cOGO hex to dOOO hex for the ASCII string 
read and print the address where it is found. A maximum of 32 
characters may be used. 
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.h cOOO dOOO 20 d2 ff 

hunt memory from cOOO hex to dOOO hex for the sequence of bytes 
20 d2 ff and print the address. A maximum of 32 bytes may be used. 
Hunt can be stopped with the stop key. 



integerate memory 
.1 fOOO 

.' fOOO 54 4f 4f 20 4d 41 4e 59 too many 
.' F008 20 46 49 4C 45 D3 46 49 FILES Fl 

displays hex and ascii until the end of memory. 

.i fOOO f080 

displays hex and ascii from fOOO hex to f080 hex. 

load from tape 
.1 

load any program from cassette No. 1 . 

.1 "ram test" 

load from cassette No. 1 the program NAMED RAM TEST 

.1 "ram test" ,02 

load from cassette No. 2 the programme NAMED RAM TEST 

beware load with a file name breaks the irq saved by the monitor. Do 
not use go command after load or save. Exit to basic and re-enter 
monitor. 



memory display 
.m 0000 0080 

.: 0000 00 01 02 03 04 05 06 07 
.: 0008 08 09 OA OB OC OD OE OF 

display memory from 0000 hex to 0080 hex. The bytes following the 
address may be modified by editing and then typing a return. 

new locater 

.n 7000 77ff 1000 0400 8000 

.n 7000 77ff 1000 0400 8000 W 

relocates machine code from 7000 hex to 77ff hex to a new location 
at 1000 hexf. New locater fixes all 3 byte instructions in the range 
0400 hex to 8000 hex. The 'W option will relocate word tables only. 
New locater will not move instructions of 00. Transfer the tables first 
then zero tables in the form copy. New locater stops and 
disassembles on a bad op code. 
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register display 
.r 

pc sr ac xr yr sp 

., 0000 01 02 03 04 05 

displays the register values saved when monitor was entered. The 
values may be changed with the edit followed by a return. 

use this instruction to set up the pc value before single stepping 
with. 

save to tape 

.s "program name" ,01 ,0800 ,0c80 

save to cassette No. 1 memory from 0800 hex up to but not 
including 0c80 hex and name it program name. 

beware save with a file name breaks the irq saved by the monitor. 
Do not use go command after load or save exit to basic and re-enter 
monitor. 

walk code 
.w 

single step starting at address in register pc. 

.w 1000 

single step starting at address 1000 hex. Walk will cause a single 
step to execute and will disassemble the next instruction. 

control speed with choice of key: 

K for single step; 
RVS for slow step: 
SPACE for fast stepping 

exit to basic 
.X 

return to basic ready mode. The stack value saved when entered will 
be restored. Care should be taken that this value is the same as 
when the monitor was entered. A cir in basic will fix any stack 
problems. 
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INDEX 



A/D converters — 1 14 
Absolute Addressing — 12 
Absolute Indexed Addressing — 12 
Accunnulator — 7, 1 1 
Addition - 8 
Addressing Modes — 11 
ArithnneticUnit - 7, 16 
Arrays — 65 
Array Fornnat — 69 
ASCII - 60,64 
ASCII files - 191 
Assennbler - 29, 39 

Basic Buffer - 48 

Basic Interpreter - 45, 47, 71 

Basic Tokens - 60,61, 191 

Binary Files - 189 

Branch — 16 

Break connnnand — 15, 25 

Carry Flag - 7, 14 

Cassette - 188 

Cassette Buffer - 49, 191 

Cassette Motor - 188 

Character Generator - 44, 113, 117, 

120, 136 
Chargot - 104 
Chip Select - 156 
Clock - 154 
Colour - 45, 137 
Colour RAM - 45, 112, 137 

Data Direction Register - 158, 160 
Data Modify Instructions — 23 
Data Storage — 65 
Decinnal Mode - 14 
Device Nunnbers - 227 
Display Modes - 120 
Display Fornnat — 134 
Division — 9 

Flags - 14, 17 

Floating Point Accunnulator - 71 
Floating Point Variables — 65 
Floppy Disk - 225 



Flow Diagranns — 34 
Function Control — 181 
Function Keys - 202 

Garbage Collection — 70 

Hand Assennbly - 34 

Handshake Lines — 181 

High Resolution Display — 127 

I/O -45, 152, 160 
I FEE 488 - 224-236 
IEEE Connector - 225 
lEEETirr^ing - 228,233 
Innnnediate Addressing — 11 
Innplied Addressing — 11 
Index Registers - 12,20,21 
Indexed Addressing — 12, 21 
Indirect Indexed Addressing — 13, 21 
Initialisation - 24, 102, 106 
Integer Variables — 65 
Interrupt - 14,24, 177 
Interrupt Disable — 14 
Interrupt Vectors — 25 
IRQ - 24, 156 

Joystick - 114,216-220 
Junnp - 16, 19 

Kernal - 90-101 
Keyboard - 197-203 
Keyboard Buffer - 199 

Light Pen - 114, 117 
Line Nunnber - 62 
Link Address - 62 
Loader - 30 

Logical File Nunnber - 227 
Logical Operations — 10 

Machine Code - 27, 32 
Machine Code Monitor - 29, 39 
Mennory Expansion - 221-223 
Mennory Map — 44 
Mennory Usage and Inst Cycle — 3 
Microprocessor 6502 — 2 
Multicolour Mode - 139 
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Multiple Precision 
Multiplication — 9 
Music - 143, 148 

Negative Flag — 15 
New Basic Instructions 
NMI - 24 

Op-Code - 16 

Operand — 16 

Operating Systenn - 45, 47, 71 

Overflow Flag - 14 

Page Zero Mennory — 12 
Processor Status Register — 14 
Progrann Counter — 16 
Progrann Storage Fornnat — 60 
Pull Accumulator - 20 
Push Accunnulator — 20 

RAM -3,44 
Recording Fornnat - 
Registers 6522 - 152 
Registers 6561 - 113, 115 
Registers RS232 - 207, 209, 21 1 
Relative Addressing — 12 
Reset Vector - 25 
ROM - 3,45 
RS-232 - 164,204-215 

Screen Centering — 115 

Senal I/O - 164, 204-215, 224-236 



Shift Register - 173 

Sound Generators - 114, 118, 144 

Stack - 19,47,81 

String Variables - 65 

Subroutines - 73,89 

Subtraction — 9 

SYS - 27, 38 

Systenn Variables - 44, 47, 50-59 

Talk and Listen - 224 
Tape Error Checking — 192 
Tape Fornnat - 190 
Tinners — 164 
Top of Mennory Pointers — 28 

User Definable Characters — 121 
User Mennory - 60 
User Port - 152-184 
USR - 27,38 

Variable Pointer - 65 
Variable Storage - 65 
Vectored Junnps - 48, 89 
VIA 6522 - 152-184 
VIC 6561 - 112-148 
Video Matnx - 115, 128 
Video RAM - 112,136 

Wedge code — 104 

Zero Flag - 15 
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